hippo-memory 1.69.0 → 1.71.0

package/dist/cli/eval.js

@@ -2,16 +2,26 @@
 import * as path from 'path';
 import * as fs from 'fs';
 import { loadAllEntries } from '../store/entry-reads.js';
-import { loadConfig } from '../config.js';
-import { getGlobalRoot } from '../shared.js';
-import { runEval, bootstrapCorpus, compareSummaries } from '../eval.js';
-import { runFeatureEval, formatResult, resultToBaseline, detectRegressions } from '../eval-suite.js';
-import { PACKAGE_VERSION } from '../version.js';
+import { loadConfig } from '../core/config.js';
+import { getGlobalRoot } from '../sharing/global-store.js';
+import { runEval, bootstrapCorpus, compareSummaries } from '../eval/eval.js';
+import { runFeatureEval, formatResult, resultToBaseline, detectRegressions } from '../eval/eval-suite.js';
+import { PACKAGE_VERSION } from '../util/version.js';
 import { printError } from './output.js';
-import { requireInit, fmt } from './shared.js';
+import { requireInit } from './shared.js';
+import { fmt } from './print.js';
+import { boolFlag } from './flag-values.js';
+import { errorMessage } from '../util/log.js';
+import { CliExit } from './exit.js';
+const HIT_TOP_K = 10;
+const MAX_FAILING_SHOWN = 10;
+const TOP_IDS_SHOWN = 3;
+const MAX_MISSED_SHOWN = 4;
+const QUERY_PREVIEW_CHARS = 60;
+const MAX_DELTAS_SHOWN = 5;
 /** Runs `hippo eval`: --bootstrap writes a corpus, --suite runs the built-in feature eval, else it scores a corpus file. */
-export async function cmdEval(hippoRoot, corpusPath, flags) {
-    const asJson = Boolean(flags['json']);
+async function cmdEval(hippoRoot, corpusPath, flags) {
+    const asJson = boolFlag(flags, 'json');
     const minMrr = flags['min-mrr'] !== undefined ? parseFloat(String(flags['min-mrr'])) : null;
     const comparePath = flags['compare'] ? String(flags['compare']) : null;
     // Suite mode doesn't need an initialized store
@@ -26,6 +36,21 @@ export async function cmdEval(hippoRoot, corpusPath, flags) {
         await runEvalSuite(hippoRoot, flags, asJson, minMrr);
         return;
     }
+    const summary = await runCorpusEval(hippoRoot, corpusPath, entries, flags);
+    if (asJson) {
+        console.log(JSON.stringify(summary, null, 2));
+    }
+    else {
+        printEvalSummary(summary, boolFlag(flags, 'show-cases'));
+    }
+    if (minMrr !== null && summary.meanMrr < minMrr) {
+        printError(`MRR ${fmt(summary.meanMrr, 4)} below threshold ${minMrr}`);
+        throw new CliExit(1);
+    }
+    if (comparePath)
+        printEvalCompare(summary, comparePath, asJson);
+}
+async function runCorpusEval(hippoRoot, corpusPath, entries, flags) {
     const cases = readCorpus(corpusPath);
     const globalRoot = getGlobalRoot();
     const localBump = flags['equal-sources']
@@ -33,7 +58,7 @@ export async function cmdEval(hippoRoot, corpusPath, flags) {
         : flags['local-bump'] !== undefined
             ? parseFloat(String(flags['local-bump']))
             : loadConfig(hippoRoot).search.localBump;
-    const summary = await runEval(cases, entries, {
+    return runEval(cases, entries, {
         hippoRoot,
         globalRoot,
         mmr: !flags['no-mmr'],
@@ -41,18 +66,6 @@ export async function cmdEval(hippoRoot, corpusPath, flags) {
         embeddingWeight: flags['embedding-weight'] !== undefined ? parseFloat(String(flags['embedding-weight'])) : undefined,
         localBump,
     });
-    if (asJson) {
-        console.log(JSON.stringify(summary, null, 2));
-    }
-    else {
-        printEvalSummary(summary, Boolean(flags['show-cases']));
-    }
-    if (minMrr !== null && summary.meanMrr < minMrr) {
-        printError(`MRR ${fmt(summary.meanMrr, 4)} below threshold ${minMrr}`);
-        process.exit(1);
-    }
-    if (comparePath)
-        printEvalCompare(summary, comparePath, asJson);
 }
 /** Bootstrap mode: emit a synthetic corpus built from the store's own memories. */
 function writeBootstrapCorpus(entries, flags) {
@@ -73,11 +86,12 @@ function writeBootstrapCorpus(entries, flags) {
 async function runEvalSuite(hippoRoot, flags, asJson, minMrr) {
     const baselinePath = flags['baseline'] ? String(flags['baseline']) : path.join(hippoRoot, 'eval-baseline.json');
     let baseline;
-    if (fs.existsSync(baselinePath)) {
-        try {
-            baseline = JSON.parse(fs.readFileSync(baselinePath, 'utf8'));
-        }
-        catch {
+    try {
+        baseline = JSON.parse(fs.readFileSync(baselinePath, 'utf8'));
+    }
+    catch (err) {
+        // No baseline file is a first run and says nothing; a file that is there and cannot be used warns.
+        if (!(err instanceof Error && 'code' in err && err.code === 'ENOENT')) {
             printError(`Warning: eval baseline ${baselinePath} is unreadable; running without it.`);
         }
     }
@@ -97,7 +111,7 @@ async function runEvalSuite(hippoRoot, flags, asJson, minMrr) {
     if (baseline) {
         const report = detectRegressions(baseline, result);
         if (report.verdict === 'REGRESSION' && minMrr === null) {
-            process.exit(1);
+            throw new CliExit(1);
         }
     }
 }
@@ -105,11 +119,11 @@ async function runEvalSuite(hippoRoot, flags, asJson, minMrr) {
 function readCorpus(corpusPath) {
     if (!corpusPath) {
         printError('Usage: hippo eval <corpus.json>  OR  hippo eval --suite [--save-baseline]  OR  hippo eval --bootstrap');
-        process.exit(1);
+        throw new CliExit(1);
     }
     if (!fs.existsSync(corpusPath)) {
         printError(`Corpus file not found: ${corpusPath}`);
-        process.exit(1);
+        throw new CliExit(1);
     }
     let cases;
     try {
@@ -119,8 +133,8 @@ function readCorpus(corpusPath) {
             throw new Error('Corpus JSON must be an array or { cases: [...] }');
     }
     catch (err) {
-        printError(`Failed to read corpus: ${err instanceof Error ? err.message : err}`);
-        process.exit(1);
+        printError(`Failed to read corpus: ${errorMessage(err)}`);
+        throw new CliExit(1);
     }
     return cases;
 }
@@ -137,14 +151,14 @@ function printEvalSummary(summary, showCases) {
         for (const c of summary.cases) {
             const exp = c.case.expectedIds.length;
             const expectedSet = new Set(c.case.expectedIds);
-            const hitTop10 = c.returnedIds.slice(0, 10).filter((id) => expectedSet.has(id));
-            const missed = c.case.expectedIds.filter((id) => !c.returnedIds.slice(0, 10).includes(id));
+            const hitTop10 = c.returnedIds.slice(0, HIT_TOP_K).filter((id) => expectedSet.has(id));
+            const missed = c.case.expectedIds.filter((id) => !c.returnedIds.slice(0, HIT_TOP_K).includes(id));
             console.log();
             console.log(`[${c.case.id}] R@10=${fmt(c.recallAt10, 2)}  MRR=${fmt(c.mrr, 2)}  expected=${exp}  hit=${hitTop10.length}`);
             console.log(`  query: ${c.case.query}`);
-            console.log(`  top 3: ${c.returnedIds.slice(0, 3).join(', ') || '(none)'}`);
+            console.log(`  top 3: ${c.returnedIds.slice(0, TOP_IDS_SHOWN).join(', ') || '(none)'}`);
             if (missed.length > 0) {
-                const shown = missed.slice(0, 4);
+                const shown = missed.slice(0, MAX_MISSED_SHOWN);
                 const more = missed.length > shown.length ? ` +${missed.length - shown.length} more` : '';
                 console.log(`  missed: ${shown.join(', ')}${more}`);
             }
@@ -154,8 +168,8 @@ function printEvalSummary(summary, showCases) {
     const failing = summary.cases.filter((c) => c.mrr === 0);
     if (failing.length > 0) {
         console.log(`${failing.length} case(s) returned zero relevant results:`);
-        for (const f of failing.slice(0, 10)) {
-            console.log(`  [${f.case.id}] "${f.case.query.slice(0, 60)}"`);
+        for (const f of failing.slice(0, MAX_FAILING_SHOWN)) {
+            console.log(`  [${f.case.id}] "${f.case.query.slice(0, QUERY_PREVIEW_CHARS)}"`);
         }
         if (failing.length > 10)
             console.log(`  ...and ${failing.length - 10} more`);
@@ -164,15 +178,15 @@ function printEvalSummary(summary, showCases) {
 function printEvalCompare(summary, comparePath, asJson) {
     if (!fs.existsSync(comparePath)) {
         printError(`Baseline file not found: ${comparePath}`);
-        process.exit(1);
+        throw new CliExit(1);
     }
     let baseline;
     try {
         baseline = JSON.parse(fs.readFileSync(comparePath, 'utf8'));
     }
     catch (err) {
-        printError(`Failed to parse baseline: ${err instanceof Error ? err.message : err}`);
-        process.exit(1);
+        printError(`Failed to parse baseline: ${errorMessage(err)}`);
+        throw new CliExit(1);
     }
     const cmp = compareSummaries(baseline, summary);
     if (asJson) {
@@ -196,11 +210,11 @@ function printEvalCompare(summary, comparePath, asJson) {
         console.log(`  only in current:  ${cmp.onlyInCurrent.length}`);
     const showPerCase = cmp.improved.length + cmp.regressed.length > 0;
     if (showPerCase) {
-        for (const d of cmp.improved.slice(0, 5)) {
+        for (const d of cmp.improved.slice(0, MAX_DELTAS_SHOWN)) {
             const delta = d.ndcgAfter - d.ndcgBefore;
             console.log(`  + [${d.id}] NDCG ${fmt(d.ndcgBefore, 2)} -> ${fmt(d.ndcgAfter, 2)} (+${fmt(delta, 3)})`);
         }
-        for (const d of cmp.regressed.slice(0, 5)) {
+        for (const d of cmp.regressed.slice(0, MAX_DELTAS_SHOWN)) {
             const delta = d.ndcgAfter - d.ndcgBefore;
             console.log(`  - [${d.id}] NDCG ${fmt(d.ndcgBefore, 2)} -> ${fmt(d.ndcgAfter, 2)} (${fmt(delta, 3)})`);
         }

package/dist/cli/exit.d.ts

@@ -0,0 +1,6 @@
+/** Thrown after the verb has printed its own message, so it carries the exit code and nothing for the entry to print. */
+export declare class CliExit extends Error {
+    readonly code: number;
+    constructor(code: number);
+}
+//# sourceMappingURL=exit.d.ts.map

package/dist/cli/exit.js

@@ -0,0 +1,11 @@
+// The one error a CLI verb throws to stop its command; runCli is the one place that turns it into the process exit code.
+/** Thrown after the verb has printed its own message, so it carries the exit code and nothing for the entry to print. */
+export class CliExit extends Error {
+    code;
+    constructor(code) {
+        super(`hippo exits with code ${code}`);
+        this.name = 'CliExit';
+        this.code = code;
+    }
+}
+//# sourceMappingURL=exit.js.map

package/dist/cli/explain.d.ts

@@ -1,4 +1,3 @@
-import { type CliFlags, type CommandContext } from './shared.js';
-export declare function cmdExplain(hippoRoot: string, query: string, flags: CliFlags): Promise<void>;
+import { type CommandContext } from './flag-values.js';
 export declare function handleExplain({ hippoRoot, args, flags }: CommandContext): Promise<void>;
 //# sourceMappingURL=explain.d.ts.map

package/dist/cli/explain.js

@@ -1,19 +1,23 @@
 // The `hippo explain` verb; main() loads it lazily from the command table.
-import { confidenceFacets } from '../memory.js';
+import { confidenceFacets } from '../core/memory.js';
 import { isInitialized } from '../store/open.js';
 import { loadSearchEntries } from '../store/search-rows.js';
 import { loadIndex } from '../store/index-and-stats.js';
-import { DEFAULT_RECALL_BUDGET } from '../search/types.js';
-import { loadConfig } from '../config.js';
-import { dropHeldCopies } from '../same-text.js';
-import { detectScope } from '../scope.js';
-import { getGlobalRoot } from '../shared.js';
-import * as api from '../api.js';
-import { resolveTenantId } from '../tenant.js';
-import { rankRecall } from '../recall-pipeline.js';
-import { printedTokens } from '../context-render.js';
+import { DEFAULT_RECALL_BUDGET } from '../core/search-types.js';
+import { loadConfig } from '../core/config.js';
+import { dropHeldCopies } from '../util/same-text.js';
+import { detectScope } from '../sharing/scope.js';
+import { getGlobalRoot } from '../sharing/global-store.js';
+import * as api from '../api/index.js';
+import { resolveTenantId } from '../store/tenant.js';
+import { cliApiContext } from './api-context.js';
+import { printedTokens } from '../api/context-render.js';
 import { printError } from './output.js';
-import { parseLimitFlag, parseBudgetFlag, requireInit, fmt, recallEntryText, recallHeading, parseAsOfFlag, engineFlags, } from './shared.js';
+import { parseLimitFlag, parseBudgetFlag, parseAsOfFlag, engineFlags, boolFlag } from './flag-values.js';
+import { requireInit } from './shared.js';
+import { fmt, recallEntryText, recallHeading } from './print.js';
+import { CliExit } from './exit.js';
+const EXPLAIN_PREVIEW_CHARS = 48;
 /** The SQL predicate drops denied rows before the window, so an unscoped probe counts what the policy hides. */
 function noteScopeHidden(hippoRoot, globalRoot, query, tenantId, requested) {
     const probe = [
@@ -26,12 +30,12 @@ function noteScopeHidden(hippoRoot, globalRoot, query, tenantId, requested) {
         printError(`[note] ${hidden} candidate${hidden === 1 ? '' : 's'} hidden by recall scope policy (pass an explicit --scope to inspect).`);
     }
 }
-export async function cmdExplain(hippoRoot, query, flags) {
+async function cmdExplain(hippoRoot, query, flags) {
     requireInit(hippoRoot);
     const budget = parseBudgetFlag(flags['budget'], DEFAULT_RECALL_BUDGET);
     const limit = parseLimitFlag(flags['limit']);
-    const asJson = Boolean(flags['json']);
-    const includeSuperseded = Boolean(flags['include-superseded']);
+    const asJson = boolFlag(flags, 'json');
+    const includeSuperseded = boolFlag(flags, 'include-superseded');
     const asOf = parseAsOfFlag(flags);
     const globalRoot = getGlobalRoot();
     const tenantId = resolveTenantId({});
@@ -46,13 +50,27 @@ export async function cmdExplain(hippoRoot, query, flags) {
     const explainIndex = loadIndex(hippoRoot);
     const cost = (r) => printedTokens(recallEntryText(r, query, false, explainGlobalOn && !explainIndex.entries[r.entry.id]));
     const entryBudget = Math.max(0, budget - printedTokens(recallHeading(budget, budget, query)));
-    const rank = await rankRecall({ hippoRoot, globalRoot: explainGlobalOn ? globalRoot : undefined, tenantId }, {
-        query, budget: entryBudget, cost, limit, includeSuperseded, asOf,
-        explicitScope, activeScope: explicitScope || detectScope(),
-        search: { ...engine, multihop: false, explain: true },
+    const slot = {};
+    await api.retrieve(cliApiContext(hippoRoot, tenantId), {
+        query,
+        cliCore: {
+            rank: {
+                budget: entryBudget, cost, limit, includeSuperseded, asOf,
+                explicitScope, activeScope: explicitScope || detectScope(),
+                search: { ...engine, multihop: false, explain: true },
+            },
+            sources: { globalRoot: explainGlobalOn ? globalRoot : undefined },
+            inspect: (ranking) => { slot.rank = ranking; },
+        },
     });
+    const rank = slot.rank;
+    if (!rank)
+        throw new Error('explain ranked but inspected nothing');
+    printExplainResults(rank, engine.usePhysics, query, asJson);
+}
+function printExplainResults(rank, usePhysics, query, asJson) {
     const hasGlobal = rank.globalEntries.length > 0;
-    const modeUsed = engine.usePhysics && !hasGlobal
+    const modeUsed = usePhysics && !hasGlobal
         ? 'physics'
         : hasGlobal ? 'searchBothHybrid' : 'hybrid';
     const results = dropHeldCopies(rank.results, (r) => r.entry);
@@ -99,7 +117,7 @@ function printExplainTable(results, query, modeUsed, candidates) {
     for (let i = 0; i < results.length; i++) {
         const r = results[i];
         const b = r.breakdown;
-        const preview = r.entry.content.replace(/\s+/g, ' ').slice(0, 48);
+        const preview = r.entry.content.replace(/\s+/g, ' ').slice(0, EXPLAIN_PREVIEW_CHARS);
         const ageStr = b ? `${b.ageDays}d` : '?';
         console.log(`${String(i + 1).padEnd(5)} ${fmt(r.score, 3).padEnd(7)} ${fmt(r.entry.strength).padEnd(9)} ${ageStr.padEnd(6)} ${r.entry.layer.padEnd(10)} ${r.entry.id.padEnd(17)} ${preview}`);
     }
@@ -150,7 +168,7 @@ export async function handleExplain({ hippoRoot, args, flags }) {
     const query = args.join(' ').trim();
     if (!query) {
         printError('Please provide a search query.');
-        process.exit(1);
+        throw new CliExit(1);
     }
     await cmdExplain(hippoRoot, query, flags);
 }

package/dist/cli/flag-values.d.ts

@@ -0,0 +1,30 @@
+import type { RecallSearchOpts } from '../api/recall-pipeline.js';
+import type { HippoConfig } from '../core/config.js';
+export declare function isBooleanFlag(value: string | boolean | string[] | undefined): value is boolean;
+export declare function isStringFlag(value: string | boolean | string[] | undefined): value is string;
+export declare function parseLimitFlag(value: string | boolean | string[] | undefined): number;
+export declare function parseCountFlag(value: string | boolean | string[] | undefined): number;
+export declare function parseBudgetFlag(value: string | boolean | string[] | undefined, fallback: number): number;
+export type CliFlags = Record<string, string | boolean | string[]>;
+export declare function parsePositiveId(idRaw: string | undefined, label: string): number;
+export declare function parseListLimit(flags: CliFlags): number;
+export declare function stringFlag(flags: CliFlags, name: string): string | undefined;
+export declare function nonEmptyStringFlag(flags: CliFlags, name: string): string | undefined;
+export declare function stringListFlag(flags: CliFlags, name: string): string[] | undefined;
+export declare function isOneOf<T extends string>(allowed: readonly T[], value: string): value is T;
+export declare function numberFlag(flags: CliFlags, name: string): number | undefined;
+export declare function boolFlag(flags: CliFlags, name: string): boolean;
+export declare function flagIsTrue(flags: CliFlags, name: string): boolean;
+/** What the command table hands each verb's run(). */
+export interface CommandContext {
+    readonly hippoRoot: string;
+    readonly tenantId: string;
+    readonly args: string[];
+    readonly flags: CliFlags;
+}
+export type EngineFlags = Pick<RecallSearchOpts, 'usePhysics' | 'physicsConfig' | 'mmr' | 'mmrLambda' | 'localBump'>;
+export declare function parseAsOfFlag(flags: CliFlags): string | undefined;
+/** --physics forces physics, --classic forces BM25+cosine, else physics unless the config turns it off. */
+export declare function engineFlags(flags: CliFlags, config: HippoConfig): EngineFlags;
+export declare function stringFlagOrExit(flags: CliFlags, key: string): string | undefined;
+//# sourceMappingURL=flag-values.d.ts.map

package/dist/cli/flag-values.js

@@ -0,0 +1,120 @@
+// Readers that turn parsed CLI flags into typed values, and the flag types they share.
+import { printError } from './output.js';
+import { CliExit } from './exit.js';
+export function isBooleanFlag(value) {
+    return typeof value === 'boolean';
+}
+export function isStringFlag(value) {
+    return typeof value === 'string';
+}
+export function parseLimitFlag(value) {
+    if (!value)
+        return Infinity;
+    const parsed = parseInt(String(value), 10);
+    return Number.isFinite(parsed) && parsed >= 1 ? parsed : Infinity;
+}
+export function parseCountFlag(value) {
+    if (!value || value === true || Array.isArray(value))
+        return 0;
+    const parsed = parseInt(String(value), 10);
+    return Number.isFinite(parsed) && parsed >= 1 ? parsed : 0;
+}
+export function parseBudgetFlag(value, fallback) {
+    if (value === undefined)
+        return fallback;
+    // A value-less flag and a junk value are different typos; the --hops guard already splits them.
+    if (!isStringFlag(value)) {
+        printError('--budget requires an integer value (e.g. --budget 1500).');
+        throw new CliExit(1);
+    }
+    // Number(), like the --hops guard: parseInt('12abc') is 12, silently accepting what this message rejects.
+    const parsed = Number(value);
+    if (!Number.isInteger(parsed) || parsed < 0) {
+        printError(`Invalid --budget: "${value}". Must be a non-negative integer.`);
+        throw new CliExit(1);
+    }
+    return parsed;
+}
+// Whole-arg digits only: parseInt alone reads "1abc" as 1 and a mutating verb would hit the wrong row. Digits past 2^53 round to a neighbouring id, so they are refused too.
+export function parsePositiveId(idRaw, label) {
+    const s = String(idRaw ?? '').trim();
+    const id = parseInt(s, 10);
+    if (!/^\d+$/.test(s) || id <= 0 || !Number.isSafeInteger(id)) {
+        printError(`Invalid ${label} id: "${idRaw}" (expected a positive integer).`);
+        throw new CliExit(1);
+    }
+    return id;
+}
+export function parseListLimit(flags) {
+    const limitRaw = flags['limit'];
+    const limit = limitRaw !== undefined ? parseInt(String(limitRaw), 10) : 100;
+    if (!Number.isFinite(limit) || limit <= 0) {
+        printError(`Invalid --limit: "${limitRaw}". Must be a positive integer.`);
+        throw new CliExit(1);
+    }
+    return limit;
+}
+// A value-less flag is `true` and a repeated one is a string[]; only a string counts here.
+export function stringFlag(flags, name) {
+    const v = flags[name];
+    return isStringFlag(v) ? v : undefined;
+}
+// An empty value reads as absent, so `--change ""` keeps the default.
+export function nonEmptyStringFlag(flags, name) {
+    return stringFlag(flags, name) || undefined;
+}
+// A repeated flag is already a list; a single value is a comma-separated list.
+export function stringListFlag(flags, name) {
+    const v = flags[name];
+    if (Array.isArray(v))
+        return v;
+    return isStringFlag(v) ? v.split(',').map((t) => t.trim()).filter(Boolean) : undefined;
+}
+export function isOneOf(allowed, value) {
+    return allowed.some((a) => a === value);
+}
+export function numberFlag(flags, name) {
+    const v = flags[name];
+    return isStringFlag(v) ? Number(v) : undefined;
+}
+// Any truthy value counts, so a string value is true too.
+export function boolFlag(flags, name) {
+    return Boolean(flags[name]);
+}
+// Only a bare switch counts; `--x value` is false.
+export function flagIsTrue(flags, name) {
+    return flags[name] === true;
+}
+export function parseAsOfFlag(flags) {
+    const asOf = stringFlag(flags, 'as-of');
+    if (asOf !== undefined && Number.isNaN(new Date(asOf).getTime())) {
+        printError(`Error: --as-of value "${asOf}" is not a valid ISO date (e.g. 2026-04-22 or 2026-04-22T12:00:00Z).`);
+        throw new CliExit(1);
+    }
+    return asOf;
+}
+/** --physics forces physics, --classic forces BM25+cosine, else physics unless the config turns it off. */
+export function engineFlags(flags, config) {
+    return {
+        usePhysics: boolFlag(flags, 'physics') || (!flags['classic'] && config.physics.enabled !== false),
+        physicsConfig: config.physics,
+        mmr: !flags['no-mmr'] && config.mmr.enabled,
+        mmrLambda: flags['mmr-lambda'] !== undefined ? parseFloat(String(flags['mmr-lambda'])) : config.mmr.lambda,
+        localBump: flags['equal-sources']
+            ? 1.0
+            : flags['local-bump'] !== undefined ? parseFloat(String(flags['local-bump'])) : config.search.localBump,
+    };
+}
+// parseArgs turns a value-less flag into `true`; refuse rather than silently
+// stringifying it (String(true) === 'true'), mirroring handleHandoff's guard.
+export function stringFlagOrExit(flags, key) {
+    const v = flags[key];
+    if (v === undefined)
+        return undefined;
+    if (v === true || v === false || Array.isArray(v)) {
+        printError(`--${key} requires a value`);
+        throw new CliExit(1);
+    }
+    return v.trim();
+}
+//# sourceMappingURL=flag-values.js.map