agentfootprint 10.2.0 → 10.3.1

package/dist/esm/lib/tool-lint/cli.js

@@ -1,203 +0,0 @@
-/**
- * Tool-lint CLI core (RFC-002 block C3 — the CI gate).
- *
- * Pattern: humble shell — `bin/agentfootprint-lint-tools.mjs` is a
- *          3-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/tool-lint/`. Reads ONE JSON file of tools, prints a
- *          report, returns the process exit code:
- *            0 — report.ok
- *            1 — findings failed the gate (!ok)
- *            2 — usage / input error (bad flags, unreadable file,
- *                unrecognized JSON shape)
- *
- * ## Embedder & gating honesty
- *
- * The CLI has no way to receive a consumer embedder, so it uses the
- * built-in deterministic mock (char-frequency, offline, dependency-free)
- * for the similarity RANKING — and, by default, does NOT gate on it:
- * without `--threshold`, similarity is report-only (relative ordering +
- * watch hints) and the exit code reflects structural findings alone.
- * Pass `--threshold` to make confusable pairs fail the gate — you own
- * the calibration at that point (start from
- * `MOCK_EMBEDDER_CALIBRATION.confusabilityThreshold` = 0.94). For real
- * embedder gating, use `analyzeToolCatalog` from
- * `agentfootprint/observe` in a small script instead.
- */
-import { mockEmbedder } from '../../memory/embedding/mockEmbedder.js';
-import { analyzeToolCatalog, MOCK_EMBEDDER_CALIBRATION } from './analyze.js';
-import { formatToolCatalogReport } from './format.js';
-const USAGE = `usage: agentfootprint-lint-tools <tools.json> [options]
-
-  <tools.json>          JSON file with your tool catalog. Accepted shapes:
-                          [{ name, description, inputSchema? }]          (plain / MCP tool)
-                          { tools: [...] }                               (MCP tools/list result)
-                          [{ type: 'function', function: {...} }]       (OpenAI)
-                          [{ name, description, input_schema }]         (Anthropic)
-
-  --threshold <num>     gate on confusable pairs at this cosine (mock-embedder
-                        starting point: ${MOCK_EMBEDDER_CALIBRATION.confusabilityThreshold}). Without it, similarity is
-                        REPORT-ONLY and only structural findings gate.
-  --watch-band <num>    advisory band below the threshold (default ${MOCK_EMBEDDER_CALIBRATION.watchBand} with --threshold)
-  --strict              structural warnings also fail the gate
-  --no-similarity       skip the similarity analysis entirely
-  --top <n>             ranked pairs to print (default 10)
-  --json                print the full report as JSON instead of text
-
-exit codes: 0 ok · 1 findings failed the gate · 2 usage/input error`;
-/**
- * Normalize any of the recognized tool-list JSON shapes to the lint's
- * plain catalog. Throws (with a shape description) on unrecognized
- * input — the CLI maps that to exit code 2.
- */
-export function coerceCatalog(json) {
-    // { tools: [...] } — MCP `tools/list` result envelope.
-    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 tools or { tools: [...] }');
-    }
-    return list.map((raw, index) => {
-        if (raw === null || typeof raw !== 'object') {
-            throw new Error(`tools[${index}] is not an object`);
-        }
-        const entry = raw;
-        // OpenAI: { type: 'function', function: { name, description, parameters } }
-        const fn = entry.type === 'function' && entry.function !== null && typeof entry.function === 'object'
-            ? entry.function
-            : entry;
-        const name = fn.name;
-        if (typeof name !== 'string' || name.length === 0) {
-            throw new Error(`tools[${index}] has no string 'name'`);
-        }
-        const description = typeof fn.description === 'string' ? fn.description : undefined;
-        // inputSchema (MCP/ours) | input_schema (Anthropic) | parameters (OpenAI)
-        const schema = fn.inputSchema ?? fn.input_schema ?? fn.parameters;
-        const inputSchema = schema !== null && typeof schema === 'object'
-            ? schema
-            : undefined;
-        return {
-            name,
-            ...(description !== undefined ? { description } : {}),
-            ...(inputSchema !== undefined ? { inputSchema } : {}),
-        };
-    });
-}
-function parseArgs(argv) {
-    let file;
-    let threshold;
-    let watchBand;
-    let strict = false;
-    let similarity = true;
-    let top = 10;
-    let json = false;
-    for (let i = 0; i < argv.length; i++) {
-        const arg = argv[i];
-        const numberFlag = (name) => {
-            const value = Number(argv[++i]);
-            if (!Number.isFinite(value))
-                throw new Error(`${name} expects a number`);
-            return value;
-        };
-        if (arg === '--threshold')
-            threshold = numberFlag('--threshold');
-        else if (arg === '--watch-band')
-            watchBand = numberFlag('--watch-band');
-        else if (arg === '--strict')
-            strict = true;
-        else if (arg === '--no-similarity')
-            similarity = false;
-        else if (arg === '--top')
-            top = numberFlag('--top');
-        else if (arg === '--json')
-            json = true;
-        else if (arg === '--help' || arg === '-h')
-            throw new Error(USAGE);
-        else if (arg.startsWith('-'))
-            throw new Error(`unknown flag '${arg}'\n\n${USAGE}`);
-        else if (file === undefined)
-            file = arg;
-        else
-            throw new Error(`unexpected extra argument '${arg}'\n\n${USAGE}`);
-    }
-    if (file === undefined)
-        throw new Error(USAGE);
-    return {
-        file,
-        ...(threshold !== undefined ? { threshold } : {}),
-        ...(watchBand !== undefined ? { watchBand } : {}),
-        strict,
-        similarity,
-        top,
-        json,
-    };
-}
-/**
- * Run the lint CLI. Returns the exit code (never calls `process.exit` —
- * the bin wrapper assigns it to `process.exitCode`).
- */
-export async function runToolLintCli(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 args;
-    try {
-        args = parseArgs(argv);
-    }
-    catch (error) {
-        io.stderr(error.message);
-        return 2;
-    }
-    let catalog;
-    try {
-        // Lazy node:fs import (browser-compat): `agentfootprint/observe`
-        // re-exports this module, and a TOP-LEVEL node:fs/promises import
-        // detonates any browser bundle at module-eval (found by the
-        // agent-playground; same lazy-gating pattern as audit's node:crypto).
-        // The CLI path is the only consumer that touches the filesystem.
-        const { readFile } = await import('node:fs/promises');
-        catalog = coerceCatalog(JSON.parse(await readFile(args.file, 'utf8')));
-    }
-    catch (error) {
-        io.stderr(`agentfootprint-lint-tools: ${args.file}: ${error.message}`);
-        return 2;
-    }
-    // Without --threshold the mock-embedder similarity is REPORT-ONLY:
-    // rank pairs at an unreachable threshold (no 'confusable'/'watch'
-    // verdicts) so only the relative-ordering section prints.
-    const gateOnSimilarity = args.threshold !== undefined;
-    const threshold = args.threshold ?? Infinity;
-    const watchBand = args.watchBand ?? (gateOnSimilarity ? MOCK_EMBEDDER_CALIBRATION.watchBand : 0);
-    const report = await analyzeToolCatalog(catalog, {
-        ...(args.similarity ? { embedder: mockEmbedder() } : {}),
-        confusabilityThreshold: threshold,
-        watchBand,
-        failOn: args.strict ? 'warn' : 'error',
-    });
-    if (args.json) {
-        io.stdout(JSON.stringify(report, null, 2));
-    }
-    else {
-        if (args.similarity) {
-            io.stdout(gateOnSimilarity
-                ? '⚠ similarity uses the built-in deterministic mock embedder — you own the ' +
-                    'calibration of --threshold (cosine ranges are per-embedder; mock compresses ' +
-                    'prose to ~0.85–0.97). Trust relative ordering first.'
-                : 'ℹ similarity is REPORT-ONLY (no --threshold): ranked pairs below are the ' +
-                    'relative-ordering view from the built-in mock embedder. Pass --threshold ' +
-                    `(mock starting point ${MOCK_EMBEDDER_CALIBRATION.confusabilityThreshold}) to gate on confusable pairs.`);
-            io.stdout('');
-        }
-        io.stdout(formatToolCatalogReport(report, { topPairs: args.top }));
-    }
-    return report.ok ? 0 : 1;
-}
-//# sourceMappingURL=cli.js.map

package/dist/esm/lib/tool-lint/cli.js.map

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

package/dist/esm/lib/tool-lint/format.d.ts

@@ -1,18 +0,0 @@
-/**
- * formatToolCatalogReport — human-readable rendering of a lint report.
- *
- * Pattern: pure presenter. One report → one string; used verbatim by the
- *          CLI (`agentfootprint-lint-tools`) and the examples so output
- *          stays byte-identical across surfaces.
- * Role:    `src/lib/tool-lint/` leaf. No I/O.
- */
-import type { ToolCatalogReport } from './types.js';
-export interface FormatReportOptions {
-    /** How many ranked pairs to show in the relative-ordering section.
-     *  Default 10. 0 hides the section. */
-    readonly topPairs?: number;
-    /** How many WATCH pairs to print before eliding the rest (the report
-     *  object always carries all of them). Default 10. */
-    readonly maxWatch?: number;
-}
-export declare function formatToolCatalogReport(report: ToolCatalogReport, options?: FormatReportOptions): string;

package/dist/esm/lib/tool-lint/format.js

@@ -1,61 +0,0 @@
-/**
- * formatToolCatalogReport — human-readable rendering of a lint report.
- *
- * Pattern: pure presenter. One report → one string; used verbatim by the
- *          CLI (`agentfootprint-lint-tools`) and the examples so output
- *          stays byte-identical across surfaces.
- * Role:    `src/lib/tool-lint/` leaf. No I/O.
- */
-export function formatToolCatalogReport(report, options = {}) {
-    const topPairs = options.topPairs ?? 10;
-    const maxWatch = options.maxWatch ?? 10;
-    const lines = [];
-    const { similarity, structural, summary } = report;
-    lines.push(`tool-catalog lint — ${report.toolCount} tools · ` +
-        `${summary.confusable} confusable · ${summary.watch} watch · ` +
-        `${summary.errors} errors · ${summary.warnings} warnings`);
-    if (similarity.analyzed) {
-        lines.push('', `confusability (threshold ${similarity.thresholds.confusabilityThreshold}, ` +
-            `watch band ${similarity.thresholds.watchBand}):`);
-        if (similarity.confusable.length === 0 && similarity.watch.length === 0) {
-            lines.push('  no pairs at or near the threshold');
-        }
-        for (const pair of similarity.confusable) {
-            lines.push(`  ✗ CONFUSABLE ${pair.similarity.toFixed(4)}  ${pair.a} <> ${pair.b}`);
-            lines.push(`      hint: ${pair.hint}`);
-        }
-        for (const pair of similarity.watch.slice(0, maxWatch)) {
-            lines.push(`  ~ watch      ${pair.similarity.toFixed(4)}  ${pair.a} <> ${pair.b}`);
-            lines.push(`      hint: ${pair.hint}`);
-        }
-        if (similarity.watch.length > maxWatch) {
-            lines.push(`  … and ${similarity.watch.length - maxWatch} more watch pairs (see report.similarity.watch)`);
-        }
-        if (topPairs > 0 && similarity.ranked.length > 0) {
-            lines.push('', `  most-similar pairs (relative ordering — top ${topPairs}):`);
-            for (const pair of similarity.ranked.slice(0, topPairs)) {
-                lines.push(`    ${pair.similarity.toFixed(4)}  ${pair.a} <> ${pair.b}`);
-            }
-        }
-    }
-    else {
-        lines.push('', 'confusability: skipped (no embedder supplied — structural rules only)');
-    }
-    if (structural.length > 0) {
-        lines.push('', 'structural findings:');
-        for (const finding of structural) {
-            const where = finding.param ? `${finding.tool}.${finding.param}` : finding.tool;
-            const mark = finding.severity === 'error' ? '✗' : '~';
-            lines.push(`  ${mark} ${finding.severity.padEnd(5)} [${finding.rule}] ${where}`);
-            lines.push(`      ${finding.message}`);
-            if (finding.suggestion)
-                lines.push(`      suggest: ${finding.suggestion}`);
-        }
-    }
-    else {
-        lines.push('', 'structural findings: none');
-    }
-    lines.push('', report.ok ? 'RESULT: ok' : 'RESULT: FAIL');
-    return lines.join('\n');
-}
-//# sourceMappingURL=format.js.map

package/dist/esm/lib/tool-lint/format.js.map

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

package/dist/esm/lib/tool-lint/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/lib/tool-lint/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAcH,OAAO,EACL,kBAAkB,EAClB,gBAAgB,EAChB,iBAAiB,EACjB,mBAAmB,EACnB,+BAA+B,EAC/B,kBAAkB,EAClB,yBAAyB,GAC1B,MAAM,cAAc,CAAC;AAEtB,OAAO,EACL,sBAAsB,EACtB,eAAe,EACf,eAAe,EACf,iBAAiB,EACjB,mBAAmB,EACnB,qBAAqB,EACrB,iBAAiB,GAIlB,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,uBAAuB,EAA4B,MAAM,aAAa,CAAC;AAEhF,OAAO,EAAE,aAAa,EAAE,cAAc,EAAsB,MAAM,UAAU,CAAC"}

package/dist/esm/lib/tool-lint/rules.d.ts

@@ -1,85 +0,0 @@
-/**
- * Structural lint rules (RFC-002 block C2) — the PLUGGABLE RULE PACK.
- *
- * Pattern: Strategy list — each rule is a plain `{ id, check }` object;
- *          `defaultStructuralRules` is OUR pack, and consumers add /
- *          remove / replace freely via `AnalyzeToolCatalogOptions.rules`.
- *          Parameterizable rules ship as FACTORIES (`descriptionRule`,
- *          `saysWhatNotWhenRule`, …) returning a configured `LintRule`.
- * Role:    `src/lib/tool-lint/` leaf. Pure functions over `CatalogTool`;
- *          no embedder, no I/O.
- *
- * Every rule encodes a FIELD FINDING from real catalogs (the Neo SAN
- * triage agent's 29-tool catalog was the seed corpus):
- *
- *   1. description-missing-or-short — the model can only guess from a name.
- *   2. says-what-not-when — describes WHAT the tool returns but gives the
- *      model no cue for WHEN to pick it over a sibling (the #1 cause of
- *      twin-tool confusion: 'get_fcns_database' vs 'influx_get_fcns_database').
- *   3. enum-in-prose — string params whose legal values are listed in prose
- *      ("avg_iops | peak_iops | mbps") instead of a JSON-Schema `enum` the
- *      model (and validators, see #9 tool-args validation) can act on.
- *   4. optional-param-undocumented — optional params whose omission has
- *      meaning (fabric-wide sweep vs one switch) but whose schema never
- *      says so; the model can't reason about leaving them out.
- *
- * Honest claim: these are token/regex HEURISTICS. They flag review
- * prompts, not certainties — expect (rare) false positives and tune via
- * the factory options instead of deleting the rule.
- */
-import type { LintRule } from './types.js';
-export interface DescriptionRuleOptions {
-    /** Descriptions shorter than this (in chars) get a `warn`. Default 40. */
-    readonly minChars?: number;
-}
-/**
- * Missing description → `error` (the model can only guess from the
- * name). Present but shorter than `minChars` → `warn` (too short to
- * differentiate from siblings).
- */
-export declare function descriptionRule(options?: DescriptionRuleOptions): LintRule;
-/** RFC-002 C2 heuristic cue list — temporal/conditional words whose
- *  presence suggests the description says WHEN to use the tool. */
-export declare const DEFAULT_WHEN_CUES: readonly string[];
-export interface SaysWhatNotWhenRuleOptions {
-    /** Cue tokens (whole-word, case-insensitive). Default `DEFAULT_WHEN_CUES`. */
-    readonly cueTokens?: readonly string[];
-}
-/**
- * A description with NO temporal/conditional cue token usually describes
- * WHAT the tool returns but never WHEN to pick it — the #1 cause of
- * twin-tool confusion. Heuristic by design: tune `cueTokens` rather than
- * dropping the rule. Skips tools with no description (rule 1's finding).
- */
-export declare function saysWhatNotWhenRule(options?: SaysWhatNotWhenRuleOptions): LintRule;
-/**
- * A string param whose description enumerates its legal values in prose
- * (pipe-separated literals, or comma lists behind "one of"/"allowed
- * values") should declare a JSON-Schema `enum` instead — the model picks
- * reliably from enums, and arg validators (#9) can enforce them. The
- * field case: Neo's `influx_get_port_ranking.metric` =
- * `"avg_iops | peak_iops | mbps"`.
- */
-export declare function enumInProseRule(): LintRule;
-/** Words that signal the description DOES say what omission means. */
-export declare const DEFAULT_OMISSION_CUES: readonly string[];
-export interface OptionalParamRuleOptions {
-    /** Cue tokens that satisfy the rule. Default `DEFAULT_OMISSION_CUES`. */
-    readonly omissionCues?: readonly string[];
-}
-/**
- * An optional param's omission usually MEANS something (Neo:
- * `influx_get_interface_counters` without `switch_name` = fabric-wide
- * sweep) — but the model can only reason about leaving a param out if
- * the description says so. No description at all, or one with no
- * omission cue, gets a `warn`.
- */
-export declare function optionalParamRule(options?: OptionalParamRuleOptions): LintRule;
-/**
- * OUR rule pack, built with default options. Compose your own:
- *
- *   rules: [...defaultStructuralRules, myRule]                 // add
- *   rules: defaultStructuralRules.filter(r => r.id !== '…')    // remove
- *   rules: [descriptionRule({ minChars: 80 }), …]              // re-tune
- */
-export declare const defaultStructuralRules: readonly LintRule[];

package/dist/esm/lib/tool-lint/rules.js

@@ -1,249 +0,0 @@
-/**
- * Structural lint rules (RFC-002 block C2) — the PLUGGABLE RULE PACK.
- *
- * Pattern: Strategy list — each rule is a plain `{ id, check }` object;
- *          `defaultStructuralRules` is OUR pack, and consumers add /
- *          remove / replace freely via `AnalyzeToolCatalogOptions.rules`.
- *          Parameterizable rules ship as FACTORIES (`descriptionRule`,
- *          `saysWhatNotWhenRule`, …) returning a configured `LintRule`.
- * Role:    `src/lib/tool-lint/` leaf. Pure functions over `CatalogTool`;
- *          no embedder, no I/O.
- *
- * Every rule encodes a FIELD FINDING from real catalogs (the Neo SAN
- * triage agent's 29-tool catalog was the seed corpus):
- *
- *   1. description-missing-or-short — the model can only guess from a name.
- *   2. says-what-not-when — describes WHAT the tool returns but gives the
- *      model no cue for WHEN to pick it over a sibling (the #1 cause of
- *      twin-tool confusion: 'get_fcns_database' vs 'influx_get_fcns_database').
- *   3. enum-in-prose — string params whose legal values are listed in prose
- *      ("avg_iops | peak_iops | mbps") instead of a JSON-Schema `enum` the
- *      model (and validators, see #9 tool-args validation) can act on.
- *   4. optional-param-undocumented — optional params whose omission has
- *      meaning (fabric-wide sweep vs one switch) but whose schema never
- *      says so; the model can't reason about leaving them out.
- *
- * Honest claim: these are token/regex HEURISTICS. They flag review
- * prompts, not certainties — expect (rare) false positives and tune via
- * the factory options instead of deleting the rule.
- */
-/** Read `properties` / `required` out of a JSON-Schema-ish inputSchema,
- *  tolerating absent or malformed shapes (rules must never throw). */
-function readObjectSchema(tool) {
-    const schema = tool.inputSchema;
-    const props = schema?.properties;
-    const properties = props !== null && typeof props === 'object'
-        ? Object.entries(props).filter((entry) => entry[1] !== null && typeof entry[1] === 'object')
-        : [];
-    const required = new Set(Array.isArray(schema?.required) ? schema.required.filter((r) => typeof r === 'string') : []);
-    return { properties, required };
-}
-function hasWholeWord(text, word) {
-    return new RegExp(`(?:^|[^a-z0-9])${escapeRegExp(word.toLowerCase())}(?:[^a-z0-9]|$)`).test(text.toLowerCase());
-}
-function escapeRegExp(s) {
-    return s.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
-}
-/**
- * Missing description → `error` (the model can only guess from the
- * name). Present but shorter than `minChars` → `warn` (too short to
- * differentiate from siblings).
- */
-export function descriptionRule(options = {}) {
-    const minChars = options.minChars ?? 40;
-    return {
-        id: 'description-missing-or-short',
-        check(tool) {
-            const description = tool.description?.trim() ?? '';
-            if (description.length === 0) {
-                return [
-                    {
-                        rule: 'description-missing-or-short',
-                        tool: tool.name,
-                        severity: 'error',
-                        message: 'tool has no description — the model can only guess from the name',
-                    },
-                ];
-            }
-            if (description.length < minChars) {
-                return [
-                    {
-                        rule: 'description-missing-or-short',
-                        tool: tool.name,
-                        severity: 'warn',
-                        message: `description is ${description.length} chars (< ${minChars}) — too short to differentiate this tool from its siblings`,
-                    },
-                ];
-            }
-            return [];
-        },
-    };
-}
-// ── Rule 2 — says WHAT, not WHEN ─────────────────────────────────────
-/** RFC-002 C2 heuristic cue list — temporal/conditional words whose
- *  presence suggests the description says WHEN to use the tool. */
-export const DEFAULT_WHEN_CUES = [
-    'for',
-    'when',
-    'after',
-    'first',
-    'fallback',
-    'only',
-];
-/**
- * A description with NO temporal/conditional cue token usually describes
- * WHAT the tool returns but never WHEN to pick it — the #1 cause of
- * twin-tool confusion. Heuristic by design: tune `cueTokens` rather than
- * dropping the rule. Skips tools with no description (rule 1's finding).
- */
-export function saysWhatNotWhenRule(options = {}) {
-    const cues = options.cueTokens ?? DEFAULT_WHEN_CUES;
-    return {
-        id: 'says-what-not-when',
-        check(tool) {
-            const description = tool.description?.trim() ?? '';
-            if (description.length === 0)
-                return [];
-            if (cues.some((cue) => hasWholeWord(description, cue)))
-                return [];
-            return [
-                {
-                    rule: 'says-what-not-when',
-                    tool: tool.name,
-                    severity: 'warn',
-                    message: 'description says WHAT the tool returns but gives no cue for WHEN to use it ' +
-                        `(no ${cues.map((c) => `'${c}'`).join('/')}) — add the choice condition, ` +
-                        'e.g. "Use when …" / "Call FIRST" / "FALLBACK if …"',
-                },
-            ];
-        },
-    };
-}
-// ── Rule 3 — enum described in prose ─────────────────────────────────
-const IDENT = '[A-Za-z][A-Za-z0-9_.-]*';
-/** `avg_iops | peak_iops | mbps` — two or more pipe-separated literals. */
-const PIPE_LIST = new RegExp(`(${IDENT})(?:\\s*\\|\\s*(?:${IDENT}))+`);
-/** `one of: red, green, blue` — comma lists only behind an explicit
- *  values marker, so free-form examples ("e.g. 1h, 24h") don't flag. */
-const COMMA_LIST = new RegExp(`(?:one of|allowed values?|valid values?|options|values)\\s*:?\\s*(${IDENT}(?:\\s*,\\s*${IDENT})+)`, 'i');
-/**
- * A string param whose description enumerates its legal values in prose
- * (pipe-separated literals, or comma lists behind "one of"/"allowed
- * values") should declare a JSON-Schema `enum` instead — the model picks
- * reliably from enums, and arg validators (#9) can enforce them. The
- * field case: Neo's `influx_get_port_ranking.metric` =
- * `"avg_iops | peak_iops | mbps"`.
- */
-export function enumInProseRule() {
-    return {
-        id: 'enum-in-prose',
-        check(tool) {
-            const findings = [];
-            const { properties } = readObjectSchema(tool);
-            for (const [param, prop] of properties) {
-                if (prop.enum !== undefined)
-                    continue;
-                if (prop.type !== undefined && prop.type !== 'string')
-                    continue;
-                const description = typeof prop.description === 'string' ? prop.description : '';
-                if (description.length === 0)
-                    continue;
-                const literals = extractProseLiterals(description);
-                if (literals === undefined)
-                    continue;
-                findings.push({
-                    rule: 'enum-in-prose',
-                    tool: tool.name,
-                    severity: 'warn',
-                    param,
-                    message: `param '${param}' lists its legal values in prose ("${description.slice(0, 80)}") — declare them as a JSON-Schema enum so the model picks reliably`,
-                    suggestion: `"enum": ${JSON.stringify(literals)}`,
-                });
-            }
-            return findings;
-        },
-    };
-}
-function extractProseLiterals(description) {
-    const pipe = PIPE_LIST.exec(description);
-    if (pipe) {
-        return pipe[0].split('|').map((v) => v.trim());
-    }
-    const comma = COMMA_LIST.exec(description);
-    if (comma) {
-        return comma[1].split(',').map((v) => v.trim());
-    }
-    return undefined;
-}
-// ── Rule 4 — optional param whose omission is undocumented ───────────
-/** Words that signal the description DOES say what omission means. */
-export const DEFAULT_OMISSION_CUES = [
-    'optional',
-    'default',
-    'defaults',
-    'omit',
-    'omitted',
-    'if not',
-    'when not',
-    'absent',
-    'all',
-    'entire',
-    'every',
-    'fallback',
-];
-/**
- * An optional param's omission usually MEANS something (Neo:
- * `influx_get_interface_counters` without `switch_name` = fabric-wide
- * sweep) — but the model can only reason about leaving a param out if
- * the description says so. No description at all, or one with no
- * omission cue, gets a `warn`.
- */
-export function optionalParamRule(options = {}) {
-    const cues = options.omissionCues ?? DEFAULT_OMISSION_CUES;
-    return {
-        id: 'optional-param-undocumented',
-        check(tool) {
-            const findings = [];
-            const { properties, required } = readObjectSchema(tool);
-            for (const [param, prop] of properties) {
-                if (required.has(param))
-                    continue;
-                const description = typeof prop.description === 'string' ? prop.description.trim() : '';
-                if (description.length === 0) {
-                    findings.push({
-                        rule: 'optional-param-undocumented',
-                        tool: tool.name,
-                        severity: 'warn',
-                        param,
-                        message: `optional param '${param}' has no description — say what happens when it is omitted (a default? a broader scope?)`,
-                    });
-                }
-                else if (!cues.some((cue) => hasWholeWord(description, cue))) {
-                    findings.push({
-                        rule: 'optional-param-undocumented',
-                        tool: tool.name,
-                        severity: 'warn',
-                        param,
-                        message: `optional param '${param}' is described but never says what omission means — add e.g. "optional — defaults to …" / "omit for all …"`,
-                    });
-                }
-            }
-            return findings;
-        },
-    };
-}
-// ── The default pack ─────────────────────────────────────────────────
-/**
- * OUR rule pack, built with default options. Compose your own:
- *
- *   rules: [...defaultStructuralRules, myRule]                 // add
- *   rules: defaultStructuralRules.filter(r => r.id !== '…')    // remove
- *   rules: [descriptionRule({ minChars: 80 }), …]              // re-tune
- */
-export const defaultStructuralRules = [
-    descriptionRule(),
-    saysWhatNotWhenRule(),
-    enumInProseRule(),
-    optionalParamRule(),
-];
-//# sourceMappingURL=rules.js.map

package/dist/esm/lib/tool-lint/rules.js.map

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