agentfootprint 10.2.0 → 10.3.1

package/dist/lib/semantics/check.js

@@ -1,176 +0,0 @@
-"use strict";
-/**
- * semantics/check — the `check:semantics` gate core (9.53.0).
- *
- * Pattern: humble shell (the tool-lint precedent) — ALL behavior lives here,
- *          unit-tested; `bin/agentfootprint-check-semantics.mjs` only resolves
- *          the built module and maps the exit code. Consumers wire the bin
- *          into their own `check:` scripts beside `check:tools`.
- * Role:    lib/ layer, pure. Judges SAMPLE RESULTS against the semantic
- *          vocabulary and the per-class rules; never executes a tool, never
- *          touches a network — the samples come from the consumer's own mock
- *          tools or fixtures, the same way `check:tools` receives a dumped
- *          catalog.
- * Emits:   N/A.
- *
- * ## Severity follows provability (the skillGraph check-up law)
- *
- * Only what the declaration PROVES wrong is an error:
- *
- *   • a `'triage'` / `'inventory'` tool whose sample result declares no
- *     coverage — the CLASS declared the requirement, the sample violates it;
- *   • a marker-bearing envelope with faults (series without grain, data
- *     without provenance, a counter-looking aggregation with `is_counter`
- *     unstated, malformed shapes) — the marker declared the vocabulary, the
- *     shape violates it.
- *
- * Everything else warns: a classed tool with NO samples (the gate cannot
- * check what it cannot see — but silence must not read as a pass), and an
- * inventory whose facts carry no render hint (useful, not provably harmful).
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.checkSemantics = void 0;
-const read_js_1 = require("../../core/agent/coverage/read.js");
-const envelope_js_1 = require("./envelope.js");
-const types_js_1 = require("./types.js");
-const projection_js_1 = require("./projection.js");
-const isPlainObject = (v) => typeof v === 'object' && v !== null && !Array.isArray(v);
-/** True when a result states its boundary through ANY recognized door: a
- *  semantic envelope with `coverage` or a `period` (honesty step 7b — a
- *  boundary in time, the same answer a `coverage()` carrying only a period
- *  gets), a `coverage()` ledger, or an `absent()` (whose `checked` IS its
- *  coverage). */
-function declaresCoverage(result) {
-    const sem = (0, envelope_js_1.readSemantics)(result);
-    if (sem !== undefined)
-        return sem.coverage !== undefined || sem.period !== undefined;
-    return (0, read_js_1.readCoverageResult)(result) !== undefined;
-}
-function classCoverageFinding(entry, resultIndex) {
-    const cls = entry.resultClass;
-    return {
-        tool: entry.name,
-        code: cls === 'triage' ? 'triage-without-coverage' : 'inventory-without-coverage',
-        severity: 'error',
-        field: 'coverage',
-        resultIndex,
-        message: `tool '${entry.name}' is declared '${cls}' but sample result ${resultIndex + 1} ` +
-            `declares no coverage — field \`coverage\` is required on every ${cls} result. ` +
-            (cls === 'triage'
-                ? `A triage that cannot say what it did NOT check turns "everything looks fine" into ` +
-                    `a claim about ground it never stood on. `
-                : `An inventory that cannot say which population it covered ("4 of 5 clusters") reads ` +
-                    `as the whole fleet. `) +
-            `Return describedResult({ …, coverage: { checked, notChecked, cannotCover } }), or coverage(result, …), ` +
-            `or absent({ … }) when nothing was found.`,
-    };
-}
-/**
- * Judge a semantics catalog. Pure; throws only on a malformed CATALOG (a
- * definition-side mistake — the CLI maps it to exit code 2), never on a
- * malformed RESULT (that is a finding, the thing this gate exists to report).
- */
-function checkSemantics(entries) {
-    if (!Array.isArray(entries)) {
-        throw new Error('checkSemantics: takes an array of { name, resultClass?, results } entries.');
-    }
-    const findings = [];
-    let checkedResults = 0;
-    entries.forEach((raw, entryIndex) => {
-        if (!isPlainObject(raw)) {
-            throw new Error(`checkSemantics: entries[${entryIndex}] is not an object.`);
-        }
-        const entry = raw;
-        if (typeof entry.name !== 'string' || entry.name.trim().length === 0) {
-            throw new Error(`checkSemantics: entries[${entryIndex}] has no tool name.`);
-        }
-        const cls = entry.resultClass;
-        if (cls !== undefined && !types_js_1.RESULT_CLASSES.includes(cls)) {
-            throw new Error(`checkSemantics: tool '${entry.name}' declares resultClass '${String(cls)}', which is ` +
-                `not a class this library has. The classes are: ${types_js_1.RESULT_CLASSES.join(', ')}. ` +
-                `Omit the field for a tool with no class rules.`);
-        }
-        const results = entry.results;
-        if (!Array.isArray(results)) {
-            throw new Error(`checkSemantics: tool '${entry.name}' has no \`results\` array — the gate judges ` +
-                `sample results; give it at least one (your mock tool's return is the natural sample).`);
-        }
-        if (cls !== undefined && results.length === 0) {
-            findings.push({
-                tool: entry.name,
-                code: 'unsampled-tool-class',
-                severity: 'warning',
-                field: 'results',
-                message: `tool '${entry.name}' is declared '${cls}' but no sample results were given — the ` +
-                    `gate cannot check what it cannot see, and a class rule with no samples is a promise ` +
-                    `nobody is keeping. Add one sample result (a mock return is enough).`,
-            });
-        }
-        if (entry.projections !== undefined) {
-            if (!Array.isArray(entry.projections))
-                throw new Error(`checkSemantics: tool '${entry.name}' projections must be an array of { before, after } fixtures.`);
-            entry.projections.forEach((pair, index) => {
-                if (!isPlainObject(pair) || !Object.hasOwn(pair, 'before') || !Object.hasOwn(pair, 'after'))
-                    throw new Error(`checkSemantics: tool '${entry.name}' projection ${index + 1} requires before and after values.`);
-                for (const issue of (0, projection_js_1.projectionSemanticsIssues)((0, projection_js_1.snapshotProjectionSemantics)(pair.before), pair.after))
-                    findings.push({
-                        tool: entry.name,
-                        ...issue,
-                        field: `projections[${index}].${issue.field}`,
-                        severity: 'error',
-                    });
-            });
-        }
-        results.forEach((result, resultIndex) => {
-            checkedResults += 1;
-            // A marker-bearing value with faults: every fault becomes a finding
-            // under the recognizer's own code, naming the field.
-            const issues = (0, envelope_js_1.explainSemantics)(result);
-            if (issues !== undefined) {
-                for (const issue of issues) {
-                    findings.push({
-                        tool: entry.name,
-                        code: issue.code,
-                        severity: 'error',
-                        field: issue.field,
-                        resultIndex,
-                        message: `tool '${entry.name}', sample result ${resultIndex + 1}: ${issue.message}`,
-                    });
-                }
-                // An unrecognizable envelope cannot be judged for class rules — the
-                // faults above are already errors, and guessing at a broken shape
-                // would report the same problem twice under two names.
-                return;
-            }
-            const sem = (0, envelope_js_1.readSemantics)(result);
-            // ── The class rules ──
-            if ((cls === 'triage' || cls === 'inventory') && !declaresCoverage(result)) {
-                findings.push(classCoverageFinding(entry, resultIndex));
-            }
-            if (cls === 'inventory' &&
-                sem !== undefined &&
-                sem.facts !== undefined &&
-                sem.render === undefined) {
-                findings.push({
-                    tool: entry.name,
-                    code: 'inventory-without-render',
-                    severity: 'warning',
-                    field: 'render',
-                    resultIndex,
-                    message: `tool '${entry.name}', sample result ${resultIndex + 1}: an inventory with ` +
-                        `\`facts\` and no \`render\` hint — a UI can still draw the rows, but the tool ` +
-                        `author knows the right columns and sort better than any consumer. Consider ` +
-                        `render: { default: 'table', columns: […] }.`,
-                });
-            }
-        });
-    });
-    return {
-        ok: !findings.some((f) => f.severity === 'error'),
-        findings,
-        checkedTools: entries.length,
-        checkedResults,
-    };
-}
-exports.checkSemantics = checkSemantics;
-//# sourceMappingURL=check.js.map

package/dist/lib/semantics/check.js.map

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

package/dist/lib/semantics/cli.js

@@ -1,179 +0,0 @@
-"use strict";
-/**
- * check:semantics CLI core (9.53.0 — the build gate).
- *
- * Pattern: humble shell (the tool-lint `cli.ts` precedent) —
- *          `bin/agentfootprint-check-semantics.mjs` is a 2-line wrapper;
- *          ALL behavior (arg parsing, catalog coercion, report, exit code)
- *          lives here so it is unit-testable without spawning a process.
- * Role:    `src/lib/semantics/`. Reads ONE JSON file of tools + sample
- *          results, prints a report, returns the process exit code:
- *            0 — report.ok (and, under --strict, zero warnings)
- *            1 — findings failed the gate
- *            2 — usage / input error (bad flags, unreadable file,
- *                unrecognized JSON shape, unknown resultClass)
- *
- * Consumers wire it beside their other gates (the `check:tools` convention):
- *
- *   "check:semantics": "node scripts/dump-semantics-catalog.mjs && agentfootprint-check-semantics semantics-catalog.json"
- *
- * The catalog is sample results — what your MOCK tools return — because the
- * gate judges result shapes, and a build must never run tools that touch
- * live systems. A mock catalog is something this ecosystem already has
- * everywhere the check matters.
- */
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
-    Object.defineProperty(o, "default", { enumerable: true, value: v });
-}) : function(o, v) {
-    o["default"] = v;
-});
-var __importStar = (this && this.__importStar) || function (mod) {
-    if (mod && mod.__esModule) return mod;
-    var result = {};
-    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
-    __setModuleDefault(result, mod);
-    return result;
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.runCheckSemanticsCli = exports.coerceSemanticsCatalog = void 0;
-const check_js_1 = require("./check.js");
-const format_js_1 = require("./format.js");
-const types_js_1 = require("./types.js");
-const USAGE = `usage: agentfootprint-check-semantics <semantics-catalog.json> [options]
-
-  <semantics-catalog.json>  JSON file of tools + sample results. Accepted shapes:
-                              [{ name, resultClass?, results: [...] }]
-                              [{ name, resultClass?, result: ... }]     (single sample)
-                              { tools: [...] }                          (either row shape)
-
-                            resultClass ∈ { ${types_js_1.RESULT_CLASSES.join(', ')} } — the class
-                            declared on defineTool({ resultClass }); omit for tools
-                            with no class rules (envelope rules still apply).
-
-  --strict                  warnings also fail the gate
-  --json                    print the full report as JSON instead of text
-
-exit codes: 0 ok · 1 findings failed the gate · 2 usage/input error`;
-/**
- * Normalize the accepted JSON shapes to the checker's catalog. Throws (with
- * a shape description) on unrecognized input — the CLI maps that to exit
- * code 2. `resultClass` values are passed through untouched; the checker is
- * the one owner of the closed-set refusal.
- */
-function coerceSemanticsCatalog(json) {
-    const list = Array.isArray(json)
-        ? json
-        : json !== null &&
-            typeof json === 'object' &&
-            Array.isArray(json.tools)
-            ? json.tools
-            : undefined;
-    if (list === undefined) {
-        throw new Error('expected a JSON array of { name, resultClass?, results } rows or { tools: [...] }');
-    }
-    return list.map((raw, index) => {
-        if (raw === null || typeof raw !== 'object' || Array.isArray(raw)) {
-            throw new Error(`tools[${index}] is not an object`);
-        }
-        const entry = raw;
-        const name = entry.name;
-        if (typeof name !== 'string' || name.length === 0) {
-            throw new Error(`tools[${index}] has no string 'name'`);
-        }
-        const results = Array.isArray(entry.results)
-            ? entry.results
-            : 'result' in entry
-                ? [entry.result]
-                : undefined;
-        if (results === undefined) {
-            throw new Error(`tools[${index}] ('${name}') has neither 'results' (an array of sample results) nor ` +
-                `'result' (one sample) — the gate judges sample results; a mock tool's return is ` +
-                `the natural sample.`);
-        }
-        return {
-            name,
-            ...(entry.resultClass !== undefined
-                ? { resultClass: entry.resultClass }
-                : {}),
-            results,
-            ...(entry.projections !== undefined
-                ? { projections: entry.projections }
-                : {}),
-        };
-    });
-}
-exports.coerceSemanticsCatalog = coerceSemanticsCatalog;
-/**
- * Run the gate CLI. Returns the exit code (never calls `process.exit` — the
- * bin wrapper assigns it to `process.exitCode`).
- */
-async function runCheckSemanticsCli(argv, io = {
-    // eslint-disable-next-line no-console
-    stdout: (line) => console.log(line),
-    // eslint-disable-next-line no-console
-    stderr: (line) => console.error(line),
-}) {
-    let file;
-    let strict = false;
-    let json = false;
-    for (const arg of argv) {
-        if (arg === '--strict')
-            strict = true;
-        else if (arg === '--json')
-            json = true;
-        else if (arg === '--help' || arg === '-h') {
-            io.stderr(USAGE);
-            return 2;
-        }
-        else if (arg.startsWith('-')) {
-            io.stderr(`unknown flag '${arg}'\n\n${USAGE}`);
-            return 2;
-        }
-        else if (file === undefined)
-            file = arg;
-        else {
-            io.stderr(`unexpected extra argument '${arg}'\n\n${USAGE}`);
-            return 2;
-        }
-    }
-    if (file === undefined) {
-        io.stderr(USAGE);
-        return 2;
-    }
-    let report;
-    try {
-        // Lazy node:fs import (browser-compat — the tool-lint precedent):
-        // `agentfootprint/observe` re-exports this module, and a top-level
-        // node:fs import detonates a browser bundle at module-eval. The CLI
-        // path is the only consumer that touches the filesystem.
-        const { readFile } = await Promise.resolve().then(() => __importStar(require('node:fs/promises')));
-        const catalog = coerceSemanticsCatalog(JSON.parse(await readFile(file, 'utf8')));
-        report = (0, check_js_1.checkSemantics)(catalog);
-    }
-    catch (error) {
-        io.stderr(`agentfootprint-check-semantics: ${file}: ${error.message}`);
-        return 2;
-    }
-    if (json)
-        io.stdout(JSON.stringify(report, null, 2));
-    else
-        io.stdout((0, format_js_1.formatSemanticsReport)(report));
-    if (!report.ok)
-        return 1;
-    if (strict && report.findings.length > 0)
-        return 1;
-    return 0;
-}
-exports.runCheckSemanticsCli = runCheckSemanticsCli;
-//# sourceMappingURL=cli.js.map

package/dist/lib/semantics/cli.js.map

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

package/dist/lib/semantics/described.js

@@ -1,235 +0,0 @@
-"use strict";
-/**
- * semantics/described — `describedResult()`, the declaration door spelled the
- * way code is written.
- *
- * Pattern: one core, one authoring door (`envelope.ts` · `mintSemantics`). This file
- *          is the camelCase door: it says how its author spells the
- *          declaration and respells each object to the wire. It judges
- *          nothing itself — every rule lives in the core, once.
- * Role:    lib/ layer, pure.
- * Emits:   N/A (the caller emits `agentfootprint.tools.semantics_declared`).
- *
- * ## One authoring spelling, one unchanged wire
- *
- * `semantic()` copied the wire's snake_case names into its declaration
- * (`measured_at`, `is_counter`, `filter_note`) beside camelCase ones
- * (`notChecked`, `cannotCover`), so an author wrote two spellings in one
- * object — and "semantic" already means vector retrieval everywhere else in
- * this library. `describedResult()` takes the same fields in camelCase and
- * mints the same wire, byte for byte. The wire does not change: the model and
- * any foreign process keep reading snake_case.
- *
- * The authoring door takes ONE spelling and refuses snake_case, quoting the key its
- * author wrote and naming the one meant (`provenance.measured_at` → "did you
- * mean `measuredAt`?"). A migration that swaps only the function name then
- * fails loudly at the line that needs the new spelling, instead of silently
- * minting without it. The declaration never accepts both spellings in one object.
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.describedResult = exports.readProvenance = exports.mintProvenance = void 0;
-const items_js_1 = require("../../core/agent/coverage/items.js");
-const refusal_js_1 = require("../../core/agent/coverage/refusal.js");
-const envelope_js_1 = require("./envelope.js");
-/**
- * Each declared key → its wire key, per object, tied to the types in BOTH
- * directions: a declared key with no wire name, or a wire name the wire type
- * does not have, fails to compile. The order is the order a refusal lists the
- * fields in.
- */
-const GRAIN_NAMES = {
-    interval: 'interval',
-    aggregation: 'aggregation',
-    isCounter: 'is_counter',
-    collapsed: 'collapsed',
-};
-const PROVENANCE_NAMES = {
-    measuredAt: 'measured_at',
-    ageSeconds: 'age_seconds',
-    source: 'source',
-    sourceExportDate: 'source_export_date',
-};
-const RENDER_NAMES = {
-    default: 'default',
-    columns: 'columns',
-    sort: 'sort',
-    filterNote: 'filter_note',
-    chartHint: 'chart_hint',
-};
-const WIRE_NAMES = {
-    grain: GRAIN_NAMES,
-    provenance: PROVENANCE_NAMES,
-    render: RENDER_NAMES,
-};
-/**
- * How this door's author spells the six snake_case wire fields — each value
- * checked against the tables above, so a renamed declared key that is not
- * renamed here fails to compile instead of naming a field nobody wrote.
- */
-const CAMEL_SPELLING = {
-    is_counter: 'isCounter',
-    measured_at: 'measuredAt',
-    age_seconds: 'ageSeconds',
-    source_export_date: 'sourceExportDate',
-    filter_note: 'filterNote',
-    chart_hint: 'chartHint',
-};
-/**
- * The nine top-level fields, tied to the type in both directions.
- */
-const DECLARATION_KEYS = Object.keys({
-    series: true,
-    facts: true,
-    edges: true,
-    grain: true,
-    provenance: true,
-    period: true,
-    coverage: true,
-    clarify: true,
-    render: true,
-});
-/**
- * `value` with each key renamed to its wire name, in the author's key order.
- * A value that is not a plain object is handed through untouched, so the rule
- * set names it for what it is — "`provenance` must be an object ({ measuredAt,
- * source, … })" — where a spread would have turned `null` into `{}` and a
- * string into indexed characters. A plain object carries only known keys
- * here: the door refused every other key first.
- */
-function toWire(field, value) {
-    if (typeof value !== 'object' || value === null || Array.isArray(value))
-        return value;
-    const names = WIRE_NAMES[field];
-    const declared = value;
-    const out = {};
-    // `Object.hasOwn`, never `names[key]` alone: a key such as `toString` would
-    // otherwise read a function off Object.prototype and rename to it.
-    for (const key of Object.keys(declared)) {
-        out[Object.hasOwn(names, key) ? names[key] : key] = declared[key];
-    }
-    return out;
-}
-const DESCRIBED_DOOR = {
-    name: 'describedResult',
-    declarationKeys: DECLARATION_KEYS,
-    derivedKeys: ['notCovered', 'not_covered'],
-    objectKeys: [
-        ['grain', Object.keys(GRAIN_NAMES)],
-        ['provenance', Object.keys(PROVENANCE_NAMES)],
-        ['coverage', items_js_1.COVERAGE_DECLARATION_KEYS],
-        ['clarify', envelope_js_1.CLARIFY_DECLARATION_KEYS],
-        ['render', Object.keys(RENDER_NAMES)],
-    ],
-    toWire,
-    spelling: CAMEL_SPELLING,
-};
-/**
- * Mint an author's (camelCase) `provenance` into the wire's spelling by THIS
- * door's rules — `absent()` asks it (honesty step 7b), so an absence says its
- * source and time in the shape, the spelling and the rule set a described
- * result does: `measuredAt` and `source` required, `ageSeconds` a finite
- * number ≥ 0, `sourceExportDate` a non-empty string, a snake_case key refused
- * naming the camelCase one. THROWS the refusal (`refused: …`) at the line the
- * author wrote. A fresh object, keys in the author's order.
- */
-function mintProvenance(declared) {
-    if (typeof declared === 'object' && declared !== null && !Array.isArray(declared)) {
-        (0, refusal_js_1.refuseUnknownKeys)(declared, Object.keys(PROVENANCE_NAMES), 'provenance');
-    }
-    const wire = toWire('provenance', declared);
-    const [first] = (0, envelope_js_1.provenanceIssues)(wire, CAMEL_SPELLING);
-    if (first !== undefined)
-        throw (0, refusal_js_1.refusal)(`${first.message} (field: ${first.field})`);
-    return wire;
-}
-exports.mintProvenance = mintProvenance;
-/**
- * Read a WIRE provenance (an absence minted anywhere — a Python helper, an
- * older process) into the record's camelCase form, by the same rule set —
- * never repaired. `{}` when none is declared (`undefined` or `null`).
- */
-function readProvenance(wire) {
-    if (wire === undefined || wire === null)
-        return {};
-    const [problem] = (0, envelope_js_1.provenanceIssues)(wire, envelope_js_1.WIRE_SPELLING);
-    if (problem !== undefined)
-        return { problem };
-    const p = wire;
-    return {
-        provenance: {
-            measuredAt: p.measured_at,
-            source: p.source,
-            ...(p.age_seconds !== undefined && { ageSeconds: p.age_seconds }),
-            ...(p.source_export_date !== undefined && { sourceExportDate: p.source_export_date }),
-        },
-    };
-}
-exports.readProvenance = readProvenance;
-/**
- * Return rows, a series or relationships from a system of record — WITH the
- * caveats that make them honest — in a shape the framework recognizes, the
- * record keeps whole, and a build gate can refuse.
- *
- * **Where it lives.** It is the tool's RESPONSE: `execute` returns it, and
- * nothing is added to the system prompt or the tool's schema. The model reads
- * a compact projection ({@link semanticsForModel}: the data, `grain`,
- * `provenance`, the `not_covered` lines composed from `coverage`, a non-null
- * `clarify` and a static note) — never the `checked` list, the `render` hints
- * or the marker. The run record keeps the FULL envelope
- * (`agentfootprint.tools.semantics_declared`), even when the result is over
- * the tool's `resultCeiling` and refused. A declared `coverage` also flows
- * through the channel `coverage()` uses, which is the only part that can reach
- * the final answer (`.limitsTravelWithTheAnswer()`).
- *
- * **Values from the data.** `provenance.measuredAt` is when the WORLD was
- * measured, taken from the data — the export's time, the moment of a live
- * read, the newest sample of a series, the end of a window — never typed in.
- * It is never parsed: the library passes your words through.
- *
- * **The period** (honesty step 7b). `period: { queried, held, readAt? }` says
- * what time the READ covered — the instants it asked for, and what the store
- * holds (or `'unknown'`) — as ISO 8601 instants with a zone. The model reads it
- * as declared; the results layer compares the instants and files its verdict
- * (covered · partly held · not held · unknown). A malformed period is refused
- * here.
- *
- * Refuses (throws, at the call site — the `absent()` law) any declaration
- * this vocabulary cannot honor: series without `grain`, series or facts
- * without `provenance.measuredAt` and `provenance.source`, a counter-looking
- * aggregation with `isCounter` unstated, and every malformed shape. Each
- * refusal starts `refused: `, names the field as you spelled it, and — inside
- * `execute` — is the call's error result, which the model reads in place of
- * the data; the run continues. A snake_case key (`measured_at`,
- * `not_checked`) is refused, naming the camelCase one.
- *
- * Use `absent()` when nothing matched and `coverage()` for
- * any other value that has limits; never wrap one helper's result in another.
- *
- * @example rows from a nightly export — the time comes from the export
- * ```ts
- * const exportTime = snapshot.exportedAt; // when the WORLD was measured
- * return describedResult({
- *   facts: rows.map((r) => ({ entity: r.vm, datastore: r.datastore, size_tb: r.sizeTb })),
- *   provenance: { measuredAt: exportTime, source: 'RVTools export' },
- *   coverage: {
- *     checked: [`every VM in the RVTools export of ${exportTime}`],
- *     cannotCover: [{ what: 'hosts that are not VMware', why: 'RVTools sees VMware only' }],
- *   },
- * });
- * ```
- *
- * @example a series — `measuredAt` is the newest sample
- * ```ts
- * const newest = rows.reduce((a, b) => (a.time > b.time ? a : b)).time;
- * return describedResult({
- *   series: rows.map((r) => ({ t: r.time, entity: r.port, metric: 'avg_iops', value: r.iops })),
- *   grain: { interval: '30m', aggregation: 'avg', isCounter: false },
- *   provenance: { measuredAt: newest, source: 'InfluxDB SwitchPortStats' },
- * });
- * ```
- */
-function describedResult(decl) {
-    return (0, envelope_js_1.mintSemantics)(decl, DESCRIBED_DOOR);
-}
-exports.describedResult = describedResult;
-//# sourceMappingURL=described.js.map

package/dist/lib/semantics/described.js.map

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