@smeltjs/core 0.1.0 → 0.3.0

package/dist/cli/args.js

@@ -1,10 +1,10 @@
 import { parseArgs } from 'node:util';
-import { SUPPORTED_LANGUAGES } from '../detect.js';
 import { CliUsageError } from '../errors.js';
-import { isStrategy, STRATEGIES } from '../plan/planners.js';
-import { STRUCTURAL_LANGUAGES } from '../plan/structural.js';
-/** The command people type. Independent of the package name. */
-export const CLI_NAME = 'smelt';
+import { CLI_NAME } from './shell.js';
+import { CLI_FLAGS } from './subcommands/flags.js';
+import { refuseForeignFlags, subcommandFor } from './subcommands/registry.js';
+export { CLI_NAME } from './shell.js';
+export { cliUsage } from './usage.js';
 /**
  * Argument parsing on `node:util.parseArgs` — stable since Node 20, which `engines`
  * already requires.
@@ -13,6 +13,12 @@ export const CLI_NAME = 'smelt';
  * import is the reason that is free: it adds no dependency, so the argument the second
  * package existed to win — keeping the library's dependency tree small — is already won.
  *
+ * The shape of this function is the shape of the subcommand seam: split the argv into
+ * flags and positionals, answer the two global flags, **look the verb up in
+ * `SUBCOMMANDS`**, refuse every flag that verb does not own with one generated
+ * message, and let the verb do its own validation. There is no per-verb branching left
+ * here — a seventh verb is a seventh file, not a seventh `if`.
+ *
  * @throws {CliUsageError} on anything the user got wrong. Never guesses.
  */
 export function parseSmeltArgs(argv) {
@@ -22,18 +28,7 @@ export function parseSmeltArgs(argv) {
             args: [...argv],
             allowPositionals: true,
             strict: true,
-            options: {
-                budget: { type: 'string' },
-                focus: { type: 'string', multiple: true },
-                language: { type: 'string' },
-                strategy: { type: 'string' },
-                ignore: { type: 'string', multiple: true },
-                cache: { type: 'string' },
-                json: { type: 'boolean' },
-                reconstruct: { type: 'boolean' },
-                help: { type: 'boolean', short: 'h' },
-                version: { type: 'boolean' },
-            },
+            options: CLI_FLAGS,
         });
     }
     catch (cause) {
@@ -41,268 +36,14 @@ export function parseSmeltArgs(argv) {
             `Run \`${CLI_NAME} --help\`.`);
     }
     const { values, positionals } = parsed;
+    // Answered before any verb, so `smelt map --help` prints the help rather than being
+    // refused for a flag `map` does not own. No verb may claim these two.
     if (values.help === true)
         return { mode: 'help', focus: [], json: false };
-    if (values.version === true) {
+    if (values.version === true)
         return { mode: 'version', focus: [], json: false };
-    }
-    if (positionals[0] === 'init') {
-        // `smelt init` is a subcommand, so a file literally named `init` needs `./init`.
-        if (positionals.length > 1) {
-            throw new CliUsageError(`${CLI_NAME}: init takes no further arguments.`);
-        }
-        const flags = Object.entries(values).filter(([, value]) => value !== undefined);
-        if (flags.length > 0) {
-            throw new CliUsageError(`${CLI_NAME}: init is interactive and takes no flags ` +
-                `(got --${flags.map(([name]) => name).join(', --')}). It asks instead.`);
-        }
-        return { mode: 'init', focus: [], json: false };
-    }
-    if (positionals[0] === 'map') {
-        // `smelt map` is a subcommand, so a file literally named `map` needs `./map`.
-        return parseMapArgs(values, positionals);
-    }
-    if (positionals[0] === 'retrieve') {
-        // A subcommand, like map and init — a file literally named `retrieve` needs `./retrieve`.
-        return parseRetrieveArgs(values, positionals);
-    }
-    if (positionals[0] === 'stats') {
-        return parseStatsArgs(values, positionals);
-    }
-    // These two belong to `smelt map` alone; silently ignoring a flag the user typed
-    // would be a setting they believed was in force.
-    if (values.ignore !== undefined || values.cache !== undefined) {
-        throw new CliUsageError(`${CLI_NAME}: --ignore and --cache belong to \`${CLI_NAME} map\`. A single-blob ` +
-            `run reads one file or stdin; there is no tree to walk and nothing to cache.`);
-    }
-    if (positionals.length > 1) {
-        throw new CliUsageError(`${CLI_NAME}: expected at most one file, got ${String(positionals.length)} ` +
-            `(${positionals.join(', ')}). smelt reads one blob at a time.`);
-    }
-    const file = positionals[0];
-    if (values.reconstruct === true) {
-        if (values.budget !== undefined) {
-            throw new CliUsageError(`${CLI_NAME}: --budget makes no sense with --reconstruct. Reconstruction puts ` +
-                `every byte back; there is nothing to fit.`);
-        }
-        return {
-            mode: 'reconstruct',
-            ...(file === undefined ? {} : { file }),
-            focus: [],
-            json: false,
-        };
-    }
-    const budgetBytes = parseBudget(values.budget);
-    const chosenStrategy = strategy(values.strategy);
-    return {
-        mode: 'smelt',
-        ...(file === undefined ? {} : { file }),
-        ...(budgetBytes === undefined ? {} : { budgetBytes }),
-        focus: values.focus ?? [],
-        ...(values.language === undefined ? {} : { language: language(values.language) }),
-        ...(chosenStrategy === undefined ? {} : { strategy: chosenStrategy }),
-        json: values.json === true,
-    };
-}
-/**
- * The `map` subcommand's own validation: exactly one directory, the map-only flags,
- * and the same budget rules as everything else — a missing `--budget` is not an
- * error *here* (the config may carry `defaultBudgetBytes`), a malformed one always is.
- */
-function parseMapArgs(values, positionals) {
-    if (positionals.length < 2) {
-        throw new CliUsageError(`${CLI_NAME}: map needs the directory to read.\n` +
-            `  ${CLI_NAME} map <dir> --budget <bytes> [--focus <term>]...`);
-    }
-    if (positionals.length > 2) {
-        throw new CliUsageError(`${CLI_NAME}: map takes exactly one directory, got ` +
-            `${String(positionals.length - 1)} (${positionals.slice(1).join(', ')}).`);
-    }
-    if (values.reconstruct === true) {
-        throw new CliUsageError(`${CLI_NAME}: --reconstruct makes no sense with map. A map elides nothing, so ` +
-            `there is nothing to put back.`);
-    }
-    if (values.language !== undefined || values.strategy !== undefined) {
-        throw new CliUsageError(`${CLI_NAME}: --language and --strategy apply to single-blob runs. map reads a ` +
-            `whole tree, detects each file's language itself, and is not a planner ` +
-            `strategy — it returns a map, not an elision plan.`);
-    }
-    const budgetBytes = parseBudget(values.budget);
-    return {
-        mode: 'map',
-        dir: positionals[1],
-        ...(budgetBytes === undefined ? {} : { budgetBytes }),
-        focus: values.focus ?? [],
-        ignore: values.ignore ?? [],
-        ...(values.cache === undefined ? {} : { cacheDir: values.cache }),
-        json: values.json === true,
-    };
-}
-/**
- * `retrieve` takes the hash and nothing else. Every flag is refused rather than
- * ignored — the command prints the exact original bytes on stdout and nothing more,
- * so a flag that changed the output would break the one contract it has, and a flag
- * silently dropped would be a setting the user believed was in force. In particular
- * there is no `--json`: the bytes ARE the output, and wrapping them would re-encode
- * what the command exists to hand back verbatim.
- */
-function parseRetrieveArgs(values, positionals) {
-    const flags = Object.entries(values).filter(([, value]) => value !== undefined);
-    if (flags.length > 0) {
-        throw new CliUsageError(`${CLI_NAME}: retrieve takes no flags (got --${flags.map(([name]) => name).join(', --')}). ` +
-            `It prints the exact original bytes for one hash, nothing else — even --json ` +
-            `would wrap what must come back verbatim.`);
-    }
-    if (positionals.length !== 2) {
-        throw new CliUsageError(`${CLI_NAME}: retrieve needs exactly one hash — the one a marker printed.\n` +
-            `  ${CLI_NAME} retrieve 84998967370f38bc`);
-    }
-    return { mode: 'retrieve', hash: positionals[1] };
-}
-/** `stats` reads counters; `--json` is its only flag, everything else is refused. */
-function parseStatsArgs(values, positionals) {
-    if (positionals.length > 1) {
-        throw new CliUsageError(`${CLI_NAME}: stats takes no further arguments, got ` +
-            `${positionals.slice(1).join(', ')}. It reports on the one configured store.`);
-    }
-    const flags = Object.entries(values).filter(([name, value]) => value !== undefined && name !== 'json');
-    if (flags.length > 0) {
-        throw new CliUsageError(`${CLI_NAME}: stats takes only --json ` +
-            `(got --${flags.map(([name]) => name).join(', --')}). It reads counters; there ` +
-            `is nothing to budget, focus or plan.`);
-    }
-    return { mode: 'stats', json: values['json'] === true };
-}
-/**
- * `--budget` has no built-in default, for the same reason `smelt()` has none: a budget
- * smelt invented would be smelt deciding how much of the caller's context to throw
- * away, silently, at a number nobody chose. A *missing* flag is not an error here,
- * though — `smelt.config.json` may carry a `defaultBudgetBytes` the user chose
- * explicitly, and the runner errors only when neither exists. A malformed value is
- * always an error.
- */
-function parseBudget(raw) {
-    if (raw === undefined)
-        return undefined;
-    if (!/^\d+$/.test(raw)) {
-        throw new CliUsageError(`${CLI_NAME}: --budget must be a whole number of bytes, got "${raw}".`);
-    }
-    const value = Number(raw);
-    if (value <= 0) {
-        throw new CliUsageError(`${CLI_NAME}: --budget must be greater than zero, got "${raw}".`);
-    }
-    return value;
-}
-function language(raw) {
-    const known = [...SUPPORTED_LANGUAGES, 'unknown'];
-    if (!known.includes(raw)) {
-        throw new CliUsageError(`${CLI_NAME}: unknown --language "${raw}". Known: ${known.join(', ')}.`);
-    }
-    return raw;
-}
-/** Membership in the {@link PLANNERS} registry is the whole validation. */
-function strategy(raw) {
-    if (raw === undefined)
-        return undefined;
-    if (!isStrategy(raw)) {
-        throw new CliUsageError(`${CLI_NAME}: unknown --strategy "${raw}". Known: ${STRATEGIES.join(', ')}.`);
-    }
-    return raw;
-}
-/** The help text. Also the closest thing the CLI has to documentation. */
-export function cliUsage() {
-    return `${CLI_NAME} — shrink text for a model, without lying about what was removed.
-
-USAGE
-  ${CLI_NAME} <file> --budget <bytes> [--focus <term>]...
-  ${CLI_NAME} --budget <bytes> [--focus <term>]... < input
-  ${CLI_NAME} map <dir> --budget <bytes> [--focus <term>]... [--ignore <entry>]... [--cache <dir>]
-  ${CLI_NAME} retrieve <hash>
-  ${CLI_NAME} stats [--json]
-  ${CLI_NAME} --reconstruct <result.json>
-  ${CLI_NAME} --reconstruct < result.json
-  ${CLI_NAME} init
-
-Smelted text goes to stdout and the report goes to stderr, so the two can be piped
-apart:  ${CLI_NAME} big.log --budget 4000 > small.log
-
-CONFIG
-  ${CLI_NAME} init walks you through writing a smelt.config.json (and optional typed
-  stubs), one question at a time; nothing is written until a final confirm. Runs read
-  the nearest smelt.config.json, walking up from the working directory, for DEFAULTS
-  only — budget, strategy, store. An explicit flag always wins, and a malformed config
-  is a usage error, never silently ignored.
-
-MAP
-  ${CLI_NAME} map <dir> renders a ranked symbol map of a whole repository — modelled
-  on Aider's repo-map (aider.chat/docs/repomap.html, design by Paul Gauthier) — to
-  stdout, with a short report on stderr. Local files only: symlinks are never
-  followed, binary files are skipped, and the map writes nothing to disk unless
-  --cache names a directory. Every included symbol carries a receipt: its
-  definition site and the measured reference counts that ranked it. Unlike a
-  smelt run, map never exits
-  1: a plan can come back over budget because ${CLI_NAME} refuses to cut regions you
-  asked to keep, but the map fits itself to the budget by construction — symbols
-  are appended in rank order until the next line would not fit.
-
-RETRIEVE & STATS
-  Every marker carries the hash of the bytes it replaced — <<smelt/v1: … —
-  retrieve("hash")>> — and the marker's retrieve("hash") is this command:
-  ${CLI_NAME} retrieve <hash> prints the exact original bytes on stdout, byte for
-  byte, nothing else. That closes the loop from pure shell: an agent that got a
-  marker asks for the bytes back with a command instead of a tool call, and the
-  retrieval is counted — asking for material back is exactly what the expansion
-  rate measures. An unknown hash and damaged bytes are distinct refusals (exit 3):
-  "never elided" and "the store was corrupted" call for different responses.
-
-  ${CLI_NAME} stats prints the same store's counters, one \`name value\` per line —
-  elisionsStored, bytesStored, retrieveCalls, uniqueRetrieved, expansionRate,
-  allElisionsRetrieved — and reading them is NOT counted as a retrieval. --json
-  emits the RetrieveStats verbatim in its own versioned envelope.
-
-  Both need somewhere for elisions to outlive the run that made them: a
-  smelt.config.json with a directory store (\`${CLI_NAME} init\` writes one). With a
-  memory store — or no config — every run's store dies with its process, so there
-  is nothing to retrieve across runs, and that is a usage error rather than a
-  quiet empty answer.
-
-OPTIONS
-  --budget <bytes>     Required, unless smelt.config.json sets defaultBudgetBytes.
-                       Soft ceiling for the output, in UTF-8 bytes (for map: a hard
-                       ceiling, met by construction). No built-in default: a budget
-                       ${CLI_NAME} invented would decide for you.
-  --focus <term>       What you were looking for. Repeatable. Matching regions and
-                       their context survive; the runs between them collapse. For
-                       map: symbols matching a term (by name or path) are promoted
-                       to the front of the fill order, ranks unchanged.
-  --language <id>      Override detection. One of: ${[...SUPPORTED_LANGUAGES, 'unknown'].join(', ')}.
-  --strategy <id>      ${STRATEGIES.join(' or ')}. Defaults to lexical, unless
-                       smelt.config.json says otherwise. structural parses
-                       ${STRUCTURAL_LANGUAGES.join(', ')};
-                       any other language is refused, never approximated.
-  --ignore <entry>     map only. Repeatable. Replaces the default ignore list
-                       (.git, node_modules): a bare name matches any path segment,
-                       an entry containing / is a root-relative prefix.
-  --cache <dir>        map only. Directory for the tags cache, keyed by content
-                       hash. Only when given does the map write to disk at all.
-  --json               Print a JSON envelope on stdout instead of the text:
-                       { format, result, elided } for a smelt run — \`result\` is
-                       the SmeltResult verbatim, \`elided\` carries the bytes, so
-                       the envelope can be reconstructed; feed it back with
-                       --reconstruct. For map: { format, map }, the RepoMap
-                       structure verbatim.
-  --reconstruct        Read a --json envelope and print the original text, byte for
-                       byte. This is Law 3 you can run from a shell.
-  -h, --help           This text.
-  --version            The package version.
-
-EXIT CODES
-  0  under budget (map is always under budget by construction)
-  1  over budget — the plan did not fit, and the report says so. Never silent.
-     map never exits 1; see MAP above.
-  2  usage error
-  3  smelt refused (a SmeltError: an unbuilt planner, an unknown hash, a corrupt store)
-  4  unexpected internal error
-`;
+    const command = subcommandFor(positionals);
+    refuseForeignFlags(command, values);
+    return command.parse(values, positionals);
 }
 //# sourceMappingURL=args.js.map

package/dist/cli/args.js.map

@@ -1 +1 @@
-{"version":3,"file":"args.js","sourceRoot":"","sources":["../../src/cli/args.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"args.js","sourceRoot":"","sources":["../../src/cli/args.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAEtC,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAE7C,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACnD,OAAO,EAAE,kBAAkB,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAE9E,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAWtC;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,cAAc,CAAC,IAAuB;IACpD,IAAI,MAAM,CAAC;IACX,IAAI,CAAC;QACH,MAAM,GAAG,SAAS,CAAC;YACjB,IAAI,EAAE,CAAC,GAAG,IAAI,CAAC;YACf,gBAAgB,EAAE,IAAI;YACtB,MAAM,EAAE,IAAI;YACZ,OAAO,EAAE,SAAS;SACnB,CAAC,CAAC;IACL,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,aAAa,CACrB,GAAG,QAAQ,KAAK,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI;YACxE,SAAS,QAAQ,YAAY,CAChC,CAAC;IACJ,CAAC;IAED,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,GAAG,MAAM,CAAC;IAEvC,oFAAoF;IACpF,sEAAsE;IACtE,IAAI,MAAM,CAAC,IAAI,KAAK,IAAI;QAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;IAC1E,IAAI,MAAM,CAAC,OAAO,KAAK,IAAI;QAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;IAEhF,MAAM,OAAO,GAAG,aAAa,CAAC,WAAW,CAAC,CAAC;IAC3C,kBAAkB,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IACpC,OAAO,OAAO,CAAC,KAAK,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;AAC5C,CAAC","sourcesContent":["import { parseArgs } from 'node:util';\n\nimport { CliUsageError } from '../errors.ts';\n\nimport { CLI_NAME } from './shell.ts';\nimport { CLI_FLAGS } from './subcommands/flags.ts';\nimport { refuseForeignFlags, subcommandFor } from './subcommands/registry.ts';\n\nexport { CLI_NAME } from './shell.ts';\nexport { cliUsage } from './usage.ts';\nexport type { CliInvocation } from './subcommands/registry.ts';\nexport type { HooksInvocation } from './subcommands/hooks.ts';\nexport type { InitInvocation } from './subcommands/init.ts';\nexport type { MapInvocation } from './subcommands/map.ts';\nexport type { RetrieveInvocation } from './subcommands/retrieve.ts';\nexport type { SmeltInvocation } from './subcommands/smelt.ts';\nexport type { StatsInvocation } from './subcommands/stats.ts';\n\nimport type { CliInvocation } from './subcommands/registry.ts';\n\n/**\n * Argument parsing on `node:util.parseArgs` — stable since Node 20, which `engines`\n * already requires.\n *\n * The CLI ships as a `bin` on the library rather than as a second package, and this\n * import is the reason that is free: it adds no dependency, so the argument the second\n * package existed to win — keeping the library's dependency tree small — is already won.\n *\n * The shape of this function is the shape of the subcommand seam: split the argv into\n * flags and positionals, answer the two global flags, **look the verb up in\n * `SUBCOMMANDS`**, refuse every flag that verb does not own with one generated\n * message, and let the verb do its own validation. There is no per-verb branching left\n * here — a seventh verb is a seventh file, not a seventh `if`.\n *\n * @throws {CliUsageError} on anything the user got wrong. Never guesses.\n */\nexport function parseSmeltArgs(argv: readonly string[]): CliInvocation {\n  let parsed;\n  try {\n    parsed = parseArgs({\n      args: [...argv],\n      allowPositionals: true,\n      strict: true,\n      options: CLI_FLAGS,\n    });\n  } catch (cause) {\n    throw new CliUsageError(\n      `${CLI_NAME}: ${cause instanceof Error ? cause.message : String(cause)}\\n` +\n        `Run \\`${CLI_NAME} --help\\`.`,\n    );\n  }\n\n  const { values, positionals } = parsed;\n\n  // Answered before any verb, so `smelt map --help` prints the help rather than being\n  // refused for a flag `map` does not own. No verb may claim these two.\n  if (values.help === true) return { mode: 'help', focus: [], json: false };\n  if (values.version === true) return { mode: 'version', focus: [], json: false };\n\n  const command = subcommandFor(positionals);\n  refuseForeignFlags(command, values);\n  return command.parse(values, positionals);\n}\n"]}

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

@@ -1 +1 @@
-{"version":3,"file":"bin.d.ts","sourceRoot":"","sources":["../../src/cli/bin.ts"],"names":[],"mappings":""}
+{"version":3,"file":"bin.d.ts","sourceRoot":"","sources":["../../src/cli/bin.ts"],"names":[],"mappings":"","sourcesContent":["#!/usr/bin/env node\nimport { readFileSync, readSync } from 'node:fs';\nimport { isatty } from 'node:tty';\nimport process from 'node:process';\n\nimport { EXIT, runCli } from './run.ts';\n\n/**\n * The `smelt` binary: the thinnest possible shell around {@link runCli}.\n *\n * Everything decidable lives in `run.ts`, which returns an exit code instead of\n * calling `exit`, so the whole CLI is testable in-process. This file owns only the\n * things that cannot be tested without a real process: the shebang, stdin on fd 0, and\n * the exit code itself. `test/cli-bin.test.ts` spawns the *built* binary for exactly\n * those things — an in-process suite cannot see them.\n *\n * Two deliberate subtleties around fd 0:\n *\n *  - **fd 0 may be non-blocking, and must still be read to EOF.** Two separate ways\n *    that happens in the wild: merely accessing `process.stdin` (even `.isTTY`) makes\n *    Node flip fd 0 into non-blocking mode, and a parent that spawned this process\n *    with piped stdio may hand over a socketpair that was *born* non-blocking. Either\n *    way a one-shot `readFileSync(0)` throws `EAGAIN` whenever the producer is slower\n *    than Node's startup — `(sleep 1; echo hi) | smelt --budget 100` used to die with\n *    an internal error. So: the TTY check is `tty.isatty(0)` (a plain syscall, no\n *    stream initialization), `process.stdin` is only handed over lazily to the one\n *    mode that needs a stream (`init`), and the read itself retries `EAGAIN` with a\n *    synchronous back-off until EOF.\n *  - **Bytes that are not UTF-8 are refused, never mangled.** Decoding invalid bytes\n *    would silently replace them with U+FFFD, and the result would still smelt,\n *    round-trip, and verify — of the wrong bytes. That violates the reversibility\n *    story at its root, so the binary refuses (exit code {@link EXIT.refused}) and\n *    names the first offending byte offset instead.\n */\n\n/** Reading fd 0 synchronously is the whole of \"works in a pipe\", with no stream plumbing. */\nfunction readStdin(): string {\n  if (isatty(0)) {\n    process.stderr.write(\n      'smelt: no input. Pass a file, or pipe text in:\\n' +\n        '  smelt src/server.ts --budget 4000\\n' +\n        '  smelt --budget 4000 --focus TypeError < build.log\\n',\n    );\n    process.exit(EXIT.usage);\n  }\n  const bytes = readAllOfFd0();\n  const offset = firstInvalidUtf8Offset(bytes);\n  if (offset !== -1) {\n    process.stderr.write(\n      `smelt: stdin is not valid UTF-8 — first invalid byte at offset ${String(offset)} ` +\n        `(0x${bytes[offset]!.toString(16).padStart(2, '0')}). Decoding it would silently ` +\n        `replace bytes with U+FFFD, and the \"original\" smelt could then reconstruct would ` +\n        `not be your original. Refusing instead.\\n`,\n    );\n    process.exit(EXIT.refused);\n  }\n  return bytes.toString('utf8');\n}\n\n/** `Atomics.wait` is the only dependency-free synchronous sleep Node offers. */\nconst sleeper = new Int32Array(new SharedArrayBuffer(4));\n\n/**\n * Every byte of fd 0, to EOF, whether the descriptor is blocking (a shell pipe, a\n * redirected file) or non-blocking (a socketpair from a spawning parent). `EAGAIN`\n * means \"no bytes yet, not EOF\" — wait briefly and try again; only a zero-byte read\n * (or Windows' `EOF` on a closed pipe) ends the loop.\n */\nfunction readAllOfFd0(): Buffer {\n  const chunks: Buffer[] = [];\n  const chunk = Buffer.alloc(1 << 16);\n  for (;;) {\n    let bytesRead: number;\n    try {\n      bytesRead = readSync(0, chunk, 0, chunk.length, null);\n    } catch (error) {\n      const code = (error as { code?: string }).code;\n      if (code === 'EAGAIN') {\n        Atomics.wait(sleeper, 0, 0, 10); // producer not ready — 10ms, then retry\n        continue;\n      }\n      if (code === 'EOF') break; // Windows raises EOF instead of returning 0\n      throw error;\n    }\n    if (bytesRead === 0) break;\n    chunks.push(Buffer.from(chunk.subarray(0, bytesRead)));\n  }\n  return Buffer.concat(chunks);\n}\n\n/**\n * The byte offset where `bytes` stops being well-formed UTF-8, or `-1` when it is\n * well-formed throughout. Implements the WHATWG/Unicode table exactly: continuation\n * ranges tightened for E0/ED/F0/F4 so overlongs, surrogates and > U+10FFFF are\n * invalid — the same sequences `Buffer.prototype.toString` would fold into U+FFFD.\n */\nfunction firstInvalidUtf8Offset(bytes: Uint8Array): number {\n  let i = 0;\n  while (i < bytes.length) {\n    const lead = bytes[i]!;\n    if (lead <= 0x7f) {\n      i += 1;\n      continue;\n    }\n    let length: number;\n    let firstLow = 0x80;\n    let firstHigh = 0xbf;\n    if (lead >= 0xc2 && lead <= 0xdf) {\n      length = 2;\n    } else if (lead >= 0xe0 && lead <= 0xef) {\n      length = 3;\n      if (lead === 0xe0) firstLow = 0xa0; // overlong\n      if (lead === 0xed) firstHigh = 0x9f; // UTF-16 surrogates\n    } else if (lead >= 0xf0 && lead <= 0xf4) {\n      length = 4;\n      if (lead === 0xf0) firstLow = 0x90; // overlong\n      if (lead === 0xf4) firstHigh = 0x8f; // above U+10FFFF\n    } else {\n      return i; // a bare continuation byte, or C0/C1/F5–FF — invalid as a lead\n    }\n    if (i + length > bytes.length) return i; // truncated sequence\n    for (let k = 1; k < length; k += 1) {\n      const continuation = bytes[i + k]!;\n      const low = k === 1 ? firstLow : 0x80;\n      const high = k === 1 ? firstHigh : 0xbf;\n      if (continuation < low || continuation > high) return i;\n    }\n    i += length;\n  }\n  return -1;\n}\n\n/** `--version` should agree with the manifest, not with a second copy of the number. */\nfunction packageVersion(): string {\n  const manifest = readFileSync(new URL('../../package.json', import.meta.url), 'utf8');\n  const parsed = JSON.parse(manifest) as { version?: string };\n  return parsed.version ?? '0.0.0';\n}\n\ntry {\n  process.exitCode = await runCli(process.argv.slice(2), {\n    stdout: (text) => void process.stdout.write(text),\n    stderr: (text) => void process.stderr.write(text),\n    stdin: readStdin,\n    version: packageVersion(),\n    cwd: process.cwd(),\n    // `smelt init` reads answers line by line, so it gets the stream, not readStdin's\n    // one-shot slurp of fd 0. A *getter*, because touching `process.stdin` at all\n    // flips fd 0 into non-blocking mode and breaks readStdin's readFileSync(0) for\n    // every other mode — only the `init` branch of runCli ever reads this property.\n    get initInput() {\n      return process.stdin;\n    },\n  });\n} catch (error) {\n  process.stderr.write(\n    `smelt: unexpected internal error — this is a bug, please report it.\\n` +\n      `${error instanceof Error ? (error.stack ?? error.message) : String(error)}\\n`,\n  );\n  process.exitCode = EXIT.unexpected;\n}\n"]}

package/dist/cli/bin.js.map

@@ -1 +1 @@
-{"version":3,"file":"bin.js","sourceRoot":"","sources":["../../src/cli/bin.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"bin.js","sourceRoot":"","sources":["../../src/cli/bin.ts"],"names":[],"mappings":"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","sourcesContent":["#!/usr/bin/env node\nimport { readFileSync, readSync } from 'node:fs';\nimport { isatty } from 'node:tty';\nimport process from 'node:process';\n\nimport { EXIT, runCli } from './run.ts';\n\n/**\n * The `smelt` binary: the thinnest possible shell around {@link runCli}.\n *\n * Everything decidable lives in `run.ts`, which returns an exit code instead of\n * calling `exit`, so the whole CLI is testable in-process. This file owns only the\n * things that cannot be tested without a real process: the shebang, stdin on fd 0, and\n * the exit code itself. `test/cli-bin.test.ts` spawns the *built* binary for exactly\n * those things — an in-process suite cannot see them.\n *\n * Two deliberate subtleties around fd 0:\n *\n *  - **fd 0 may be non-blocking, and must still be read to EOF.** Two separate ways\n *    that happens in the wild: merely accessing `process.stdin` (even `.isTTY`) makes\n *    Node flip fd 0 into non-blocking mode, and a parent that spawned this process\n *    with piped stdio may hand over a socketpair that was *born* non-blocking. Either\n *    way a one-shot `readFileSync(0)` throws `EAGAIN` whenever the producer is slower\n *    than Node's startup — `(sleep 1; echo hi) | smelt --budget 100` used to die with\n *    an internal error. So: the TTY check is `tty.isatty(0)` (a plain syscall, no\n *    stream initialization), `process.stdin` is only handed over lazily to the one\n *    mode that needs a stream (`init`), and the read itself retries `EAGAIN` with a\n *    synchronous back-off until EOF.\n *  - **Bytes that are not UTF-8 are refused, never mangled.** Decoding invalid bytes\n *    would silently replace them with U+FFFD, and the result would still smelt,\n *    round-trip, and verify — of the wrong bytes. That violates the reversibility\n *    story at its root, so the binary refuses (exit code {@link EXIT.refused}) and\n *    names the first offending byte offset instead.\n */\n\n/** Reading fd 0 synchronously is the whole of \"works in a pipe\", with no stream plumbing. */\nfunction readStdin(): string {\n  if (isatty(0)) {\n    process.stderr.write(\n      'smelt: no input. Pass a file, or pipe text in:\\n' +\n        '  smelt src/server.ts --budget 4000\\n' +\n        '  smelt --budget 4000 --focus TypeError < build.log\\n',\n    );\n    process.exit(EXIT.usage);\n  }\n  const bytes = readAllOfFd0();\n  const offset = firstInvalidUtf8Offset(bytes);\n  if (offset !== -1) {\n    process.stderr.write(\n      `smelt: stdin is not valid UTF-8 — first invalid byte at offset ${String(offset)} ` +\n        `(0x${bytes[offset]!.toString(16).padStart(2, '0')}). Decoding it would silently ` +\n        `replace bytes with U+FFFD, and the \"original\" smelt could then reconstruct would ` +\n        `not be your original. Refusing instead.\\n`,\n    );\n    process.exit(EXIT.refused);\n  }\n  return bytes.toString('utf8');\n}\n\n/** `Atomics.wait` is the only dependency-free synchronous sleep Node offers. */\nconst sleeper = new Int32Array(new SharedArrayBuffer(4));\n\n/**\n * Every byte of fd 0, to EOF, whether the descriptor is blocking (a shell pipe, a\n * redirected file) or non-blocking (a socketpair from a spawning parent). `EAGAIN`\n * means \"no bytes yet, not EOF\" — wait briefly and try again; only a zero-byte read\n * (or Windows' `EOF` on a closed pipe) ends the loop.\n */\nfunction readAllOfFd0(): Buffer {\n  const chunks: Buffer[] = [];\n  const chunk = Buffer.alloc(1 << 16);\n  for (;;) {\n    let bytesRead: number;\n    try {\n      bytesRead = readSync(0, chunk, 0, chunk.length, null);\n    } catch (error) {\n      const code = (error as { code?: string }).code;\n      if (code === 'EAGAIN') {\n        Atomics.wait(sleeper, 0, 0, 10); // producer not ready — 10ms, then retry\n        continue;\n      }\n      if (code === 'EOF') break; // Windows raises EOF instead of returning 0\n      throw error;\n    }\n    if (bytesRead === 0) break;\n    chunks.push(Buffer.from(chunk.subarray(0, bytesRead)));\n  }\n  return Buffer.concat(chunks);\n}\n\n/**\n * The byte offset where `bytes` stops being well-formed UTF-8, or `-1` when it is\n * well-formed throughout. Implements the WHATWG/Unicode table exactly: continuation\n * ranges tightened for E0/ED/F0/F4 so overlongs, surrogates and > U+10FFFF are\n * invalid — the same sequences `Buffer.prototype.toString` would fold into U+FFFD.\n */\nfunction firstInvalidUtf8Offset(bytes: Uint8Array): number {\n  let i = 0;\n  while (i < bytes.length) {\n    const lead = bytes[i]!;\n    if (lead <= 0x7f) {\n      i += 1;\n      continue;\n    }\n    let length: number;\n    let firstLow = 0x80;\n    let firstHigh = 0xbf;\n    if (lead >= 0xc2 && lead <= 0xdf) {\n      length = 2;\n    } else if (lead >= 0xe0 && lead <= 0xef) {\n      length = 3;\n      if (lead === 0xe0) firstLow = 0xa0; // overlong\n      if (lead === 0xed) firstHigh = 0x9f; // UTF-16 surrogates\n    } else if (lead >= 0xf0 && lead <= 0xf4) {\n      length = 4;\n      if (lead === 0xf0) firstLow = 0x90; // overlong\n      if (lead === 0xf4) firstHigh = 0x8f; // above U+10FFFF\n    } else {\n      return i; // a bare continuation byte, or C0/C1/F5–FF — invalid as a lead\n    }\n    if (i + length > bytes.length) return i; // truncated sequence\n    for (let k = 1; k < length; k += 1) {\n      const continuation = bytes[i + k]!;\n      const low = k === 1 ? firstLow : 0x80;\n      const high = k === 1 ? firstHigh : 0xbf;\n      if (continuation < low || continuation > high) return i;\n    }\n    i += length;\n  }\n  return -1;\n}\n\n/** `--version` should agree with the manifest, not with a second copy of the number. */\nfunction packageVersion(): string {\n  const manifest = readFileSync(new URL('../../package.json', import.meta.url), 'utf8');\n  const parsed = JSON.parse(manifest) as { version?: string };\n  return parsed.version ?? '0.0.0';\n}\n\ntry {\n  process.exitCode = await runCli(process.argv.slice(2), {\n    stdout: (text) => void process.stdout.write(text),\n    stderr: (text) => void process.stderr.write(text),\n    stdin: readStdin,\n    version: packageVersion(),\n    cwd: process.cwd(),\n    // `smelt init` reads answers line by line, so it gets the stream, not readStdin's\n    // one-shot slurp of fd 0. A *getter*, because touching `process.stdin` at all\n    // flips fd 0 into non-blocking mode and breaks readStdin's readFileSync(0) for\n    // every other mode — only the `init` branch of runCli ever reads this property.\n    get initInput() {\n      return process.stdin;\n    },\n  });\n} catch (error) {\n  process.stderr.write(\n    `smelt: unexpected internal error — this is a bug, please report it.\\n` +\n      `${error instanceof Error ? (error.stack ?? error.message) : String(error)}\\n`,\n  );\n  process.exitCode = EXIT.unexpected;\n}\n"]}

package/dist/cli/config.d.ts

@@ -1,3 +1,4 @@
+import type { EnforcementMode } from '../hooks/guard-core.ts';
 import type { Strategy } from '../plan/planners.ts';
 /**
  * `smelt.config.json` — CLI defaults, and nothing more.
@@ -27,6 +28,25 @@ export type SmeltConfigStore = {
     /** Resolved relative to the directory holding the config file, not the cwd. */
     readonly path: string;
 };
+/**
+ * The `hooks` block — settings for the harness guard (`smelt hooks install`).
+ *
+ * Parsed strictly here, like every other key: the CLI refuses a malformed config.
+ * The guard core (`src/hooks/guard-core.ts`) reads the same file with its own
+ * *tolerant* reader — a guard running inside somebody's session fails open where the
+ * CLI correctly refuses — and `test/hooks-guard-core.test.ts` pins the two readers to
+ * the same key names and defaults so they cannot drift apart.
+ */
+export interface SmeltConfigHooks {
+    /** Reads at or under this many bytes pass the guard untouched. Default 8192. */
+    readonly thresholdBytes?: number;
+    /**
+     * `'deny'` (default): oversized raw reads are refused with a reason naming the
+     * exact replacement command. `'rewrite'`: on harnesses whose hooks can modify tool
+     * input, the command is substituted instead (never silently — the reason says so).
+     */
+    readonly enforcement?: EnforcementMode;
+}
 /** The parsed shape of `smelt.config.json`. Every field beyond the version is optional. */
 export interface SmeltConfig {
     readonly smeltConfig: typeof CONFIG_VERSION;
@@ -36,6 +56,8 @@ export interface SmeltConfig {
     readonly strategy?: Strategy;
     /** Used for every run; there is no store flag. Defaults to memory when absent. */
     readonly store?: SmeltConfigStore;
+    /** Settings for the harness guard. See {@link SmeltConfigHooks}. */
+    readonly hooks?: SmeltConfigHooks;
 }
 /** A config plus where it was found — the path matters for resolving `store.path`. */
 export interface LoadedConfig {
@@ -68,6 +90,46 @@ export declare function loadNearestConfig(cwd: string): LoadedConfig | undefined
  * @throws {CliUsageError} naming the file and the exact problem.
  */
 export declare function parseConfig(text: string, path: string): SmeltConfig;
+/**
+ * Serialize a config back to the bytes of a `smelt.config.json` — {@link parseConfig}'s
+ * inverse, and the **only** writer of this file.
+ *
+ * The module that owns the schema owns both directions. It used to own only the read:
+ * two modules hand-built a config object and stringified it — the `init` wizard and
+ * `hooks install` — and they had already drifted, one always emitting `strategy` and
+ * the other only when it was carried. A sixth key would have been written by whichever
+ * module its author was editing and silently dropped by the other, which is the
+ * "setting the user believed was in force" failure this file refuses everywhere else.
+ *
+ * Key order is fixed here — the reader's own key order, top level and inside `store`
+ * and `hooks` — so a re-run diffs cleanly no matter which verb wrote the file, and two
+ * writers can never disagree about shape. What goes *into* the config stays each
+ * verb's policy: the wizard's choices, and `hooks install`'s directory-store injection.
+ * Absent keys are omitted rather than written as `null`, so
+ * `parseConfig(renderConfig(c))` returns `c` field for field —
+ * `test/guards/config-writer.test.ts` pins that round trip.
+ */
+export declare function renderConfig(config: SmeltConfig): string;
 /** `store.path` is relative to the config file, so the config works from any cwd. */
 export declare function resolveStorePath(loaded: LoadedConfig, path: string): string;
+/**
+ * The store decision a config carries, with `path` already resolved against the config
+ * file's directory — one config serves every subdirectory it covers without scattering
+ * store roots. `'memory'` is the built-in default: a fresh in-memory store per run.
+ */
+export type ConfiguredStore = {
+    readonly kind: 'memory';
+} | {
+    readonly kind: 'directory';
+    readonly path: string;
+};
+/**
+ * The store leg of every merge, read once here rather than in each verb that needs it.
+ *
+ * There is no store flag, so this leg is config-or-built-in only — which is exactly
+ * why it belongs to the config module and not to a verb: `smelt` builds a store from
+ * it, and `retrieve`/`stats` refuse when it is not a directory (see `resolveStoreRun`
+ * in `subcommands/retrieve.ts`). Three verbs, one reading of the same key.
+ */
+export declare function configuredStore(config: LoadedConfig | undefined): ConfiguredStore;
 //# sourceMappingURL=config.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/cli/config.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAIpD;;;;;;;;;;;;;;;GAeG;AAEH,mEAAmE;AACnE,eAAO,MAAM,gBAAgB,sBAAsB,CAAC;AAEpD,sDAAsD;AACtD,eAAO,MAAM,cAAc,IAAI,CAAC;AAEhC,wDAAwD;AACxD,MAAM,MAAM,gBAAgB,GACxB;IAAE,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAA;CAAE,GAC3B;IACE,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAC3B,+EAA+E;IAC/E,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB,CAAC;AAEN,2FAA2F;AAC3F,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,WAAW,EAAE,OAAO,cAAc,CAAC;IAC5C,sFAAsF;IACtF,QAAQ,CAAC,kBAAkB,CAAC,EAAE,MAAM,CAAC;IACrC,2FAA2F;IAC3F,QAAQ,CAAC,QAAQ,CAAC,EAAE,QAAQ,CAAC;IAC7B,kFAAkF;IAClF,QAAQ,CAAC,KAAK,CAAC,EAAE,gBAAgB,CAAC;CACnC;AAED,sFAAsF;AACtF,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;CAC9B;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAS9D;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS,CAIvE;AAED;;;;;;;;;GASG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,WAAW,CA6DnE;AA6BD,qFAAqF;AACrF,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAE3E"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/cli/config.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAE9D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAIpD;;;;;;;;;;;;;;;GAeG;AAEH,mEAAmE;AACnE,eAAO,MAAM,gBAAgB,sBAAsB,CAAC;AAEpD,sDAAsD;AACtD,eAAO,MAAM,cAAc,IAAI,CAAC;AAEhC,wDAAwD;AACxD,MAAM,MAAM,gBAAgB,GACxB;IAAE,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAA;CAAE,GAC3B;IACE,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAC3B,+EAA+E;IAC/E,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB,CAAC;AAEN;;;;;;;;GAQG;AACH,MAAM,WAAW,gBAAgB;IAC/B,gFAAgF;IAChF,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IACjC;;;;OAIG;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE,eAAe,CAAC;CACxC;AAED,2FAA2F;AAC3F,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,WAAW,EAAE,OAAO,cAAc,CAAC;IAC5C,sFAAsF;IACtF,QAAQ,CAAC,kBAAkB,CAAC,EAAE,MAAM,CAAC;IACrC,2FAA2F;IAC3F,QAAQ,CAAC,QAAQ,CAAC,EAAE,QAAQ,CAAC;IAC7B,kFAAkF;IAClF,QAAQ,CAAC,KAAK,CAAC,EAAE,gBAAgB,CAAC;IAClC,oEAAoE;IACpE,QAAQ,CAAC,KAAK,CAAC,EAAE,gBAAgB,CAAC;CACnC;AAED,sFAAsF;AACtF,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;CAC9B;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAS9D;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS,CAIvE;AAED;;;;;;;;;GASG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,WAAW,CA+DnE;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,WAAW,GAAG,MAAM,CAWxD;AAiFD,qFAAqF;AACrF,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAE3E;AAED;;;;GAIG;AACH,MAAM,MAAM,eAAe,GACzB;IAAE,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAA;CAAE,GAAG;IAAE,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAEtF;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,YAAY,GAAG,SAAS,GAAG,eAAe,CAKjF","sourcesContent":["import { existsSync, readFileSync } from 'node:fs';\nimport { dirname, join, resolve } from 'node:path';\n\nimport { CliUsageError } from '../errors.ts';\nimport { ENFORCEMENT_MODES } from '../hooks/guard-core.ts';\nimport type { EnforcementMode } from '../hooks/guard-core.ts';\nimport { isStrategy, STRATEGIES } from '../plan/planners.ts';\nimport type { Strategy } from '../plan/planners.ts';\n\nimport { CLI_NAME } from './shell.ts';\n\n/**\n * `smelt.config.json` — CLI defaults, and nothing more.\n *\n * This file exists so `smelt` can be run without retyping the same flags, and it is\n * deliberately a *CLI* concern: the programmatic API never reads it. A library that\n * reads config files off the caller's disk is a library whose behaviour depends on\n * where it was invoked from, which is exactly the class of invisible input smelt\n * refuses. `createSmelter()` takes explicit arguments; the CLI translates this file\n * into those arguments, and explicit flags always win over it.\n *\n * The schema is versioned (`\"smeltConfig\": 1`) for the same reason the marker and the\n * `--json` envelope are: files outlive the binaries that wrote them, and a mismatch\n * must be identifiable rather than half-understood. Parsing is strict — an unknown\n * key, a wrong type, or an unknown version is a {@link CliUsageError}, never a shrug.\n * A config the CLI silently ignored would be a budget the user *thought* they set.\n */\n\n/** The file name looked for, from the working directory upward. */\nexport const CONFIG_FILE_NAME = 'smelt.config.json';\n\n/** The schema version this build reads and writes. */\nexport const CONFIG_VERSION = 1;\n\n/** Where the CLI's elision store lives between runs. */\nexport type SmeltConfigStore =\n  | { readonly kind: 'memory' }\n  | {\n      readonly kind: 'directory';\n      /** Resolved relative to the directory holding the config file, not the cwd. */\n      readonly path: string;\n    };\n\n/**\n * The `hooks` block — settings for the harness guard (`smelt hooks install`).\n *\n * Parsed strictly here, like every other key: the CLI refuses a malformed config.\n * The guard core (`src/hooks/guard-core.ts`) reads the same file with its own\n * *tolerant* reader — a guard running inside somebody's session fails open where the\n * CLI correctly refuses — and `test/hooks-guard-core.test.ts` pins the two readers to\n * the same key names and defaults so they cannot drift apart.\n */\nexport interface SmeltConfigHooks {\n  /** Reads at or under this many bytes pass the guard untouched. Default 8192. */\n  readonly thresholdBytes?: number;\n  /**\n   * `'deny'` (default): oversized raw reads are refused with a reason naming the\n   * exact replacement command. `'rewrite'`: on harnesses whose hooks can modify tool\n   * input, the command is substituted instead (never silently — the reason says so).\n   */\n  readonly enforcement?: EnforcementMode;\n}\n\n/** The parsed shape of `smelt.config.json`. Every field beyond the version is optional. */\nexport interface SmeltConfig {\n  readonly smeltConfig: typeof CONFIG_VERSION;\n  /** Used when a `smelt` run omits `--budget`. UTF-8 bytes, like every smelt budget. */\n  readonly defaultBudgetBytes?: number;\n  /** Used when a run omits `--strategy`. Validated against the {@link PLANNERS} registry. */\n  readonly strategy?: Strategy;\n  /** Used for every run; there is no store flag. Defaults to memory when absent. */\n  readonly store?: SmeltConfigStore;\n  /** Settings for the harness guard. See {@link SmeltConfigHooks}. */\n  readonly hooks?: SmeltConfigHooks;\n}\n\n/** A config plus where it was found — the path matters for resolving `store.path`. */\nexport interface LoadedConfig {\n  readonly path: string;\n  readonly config: SmeltConfig;\n}\n\n/**\n * The nearest `smelt.config.json`, walking up from `cwd` to the filesystem root —\n * the same discovery shape as `package.json`, so a config at a repo root covers the\n * whole tree. `undefined` when there is none, which is not an error: flags alone are\n * a complete interface.\n */\nexport function findConfigFile(cwd: string): string | undefined {\n  let dir = resolve(cwd);\n  for (;;) {\n    const candidate = join(dir, CONFIG_FILE_NAME);\n    if (existsSync(candidate)) return candidate;\n    const parent = dirname(dir);\n    if (parent === dir) return undefined;\n    dir = parent;\n  }\n}\n\n/**\n * Find and parse the nearest config. `undefined` when no file exists; a file that\n * exists but is malformed **throws** — see {@link parseConfig}. The distinction is the\n * point: \"no config\" is a fine state, \"a config you cannot have meant\" is not.\n *\n * @throws {CliUsageError} when a config file exists and is malformed.\n */\nexport function loadNearestConfig(cwd: string): LoadedConfig | undefined {\n  const path = findConfigFile(cwd);\n  if (path === undefined) return undefined;\n  return { path, config: parseConfig(readFileSync(path, 'utf8'), path) };\n}\n\n/**\n * Parse and validate one config file, strictly.\n *\n * Strict means: unknown keys are refused, not skipped. A typo'd `defaultBudgetByte`\n * that parsed cleanly would leave the user believing a default was set while every\n * run ignored it — a config error whose failure mode is *silence*, which is the one\n * failure shape this project refuses everywhere else too.\n *\n * @throws {CliUsageError} naming the file and the exact problem.\n */\nexport function parseConfig(text: string, path: string): SmeltConfig {\n  const bad = (why: string): CliUsageError =>\n    new CliUsageError(\n      `${CLI_NAME}: malformed ${CONFIG_FILE_NAME} at ${path}: ${why}\\n` +\n        `Fix it or delete it — a config smelt cannot read is never silently ignored. ` +\n        `\\`${CLI_NAME} init\\` can rewrite it.`,\n    );\n\n  let value: unknown;\n  try {\n    value = JSON.parse(text);\n  } catch (cause) {\n    throw bad(`not JSON (${cause instanceof Error ? cause.message : String(cause)}).`);\n  }\n  if (typeof value !== 'object' || value === null || Array.isArray(value)) {\n    throw bad('expected a JSON object at the top level.');\n  }\n  const fields = value as Record<string, unknown>;\n\n  if (fields['smeltConfig'] !== CONFIG_VERSION) {\n    throw bad(\n      `\"smeltConfig\" is ${JSON.stringify(fields['smeltConfig'])}; this build reads version ` +\n        `${String(CONFIG_VERSION)}. The schema is versioned so a mismatch is visible ` +\n        `instead of half-understood.`,\n    );\n  }\n\n  const known = ['smeltConfig', 'defaultBudgetBytes', 'strategy', 'store', 'hooks'];\n  const unknown = Object.keys(fields).filter((key) => !known.includes(key));\n  if (unknown.length > 0) {\n    throw bad(\n      `unknown key${unknown.length === 1 ? '' : 's'} ${unknown.map((k) => `\"${k}\"`).join(', ')}. ` +\n        `Known keys: ${known.join(', ')}. Unknown keys are refused because a typo that ` +\n        `parsed cleanly would be a setting you believed was set.`,\n    );\n  }\n\n  const budget = fields['defaultBudgetBytes'];\n  if (budget !== undefined && (typeof budget !== 'number' || !Number.isInteger(budget))) {\n    throw bad(`\"defaultBudgetBytes\" must be a whole number of UTF-8 bytes.`);\n  }\n  if (typeof budget === 'number' && budget <= 0) {\n    throw bad(`\"defaultBudgetBytes\" must be greater than zero, got ${String(budget)}.`);\n  }\n\n  const strategy = fields['strategy'];\n  if (strategy !== undefined && (typeof strategy !== 'string' || !isStrategy(strategy))) {\n    throw bad(\n      `\"strategy\" must be ${STRATEGIES.map((s) => `\"${s}\"`).join(' or ')}, ` +\n        `got ${JSON.stringify(strategy)}.`,\n    );\n  }\n\n  const store = parseStore(fields['store'], bad);\n  const hooks = parseHooks(fields['hooks'], bad);\n\n  return {\n    smeltConfig: CONFIG_VERSION,\n    ...(budget === undefined ? {} : { defaultBudgetBytes: budget }),\n    ...(strategy === undefined ? {} : { strategy }),\n    ...(store === undefined ? {} : { store }),\n    ...(hooks === undefined ? {} : { hooks }),\n  };\n}\n\n/**\n * Serialize a config back to the bytes of a `smelt.config.json` — {@link parseConfig}'s\n * inverse, and the **only** writer of this file.\n *\n * The module that owns the schema owns both directions. It used to own only the read:\n * two modules hand-built a config object and stringified it — the `init` wizard and\n * `hooks install` — and they had already drifted, one always emitting `strategy` and\n * the other only when it was carried. A sixth key would have been written by whichever\n * module its author was editing and silently dropped by the other, which is the\n * \"setting the user believed was in force\" failure this file refuses everywhere else.\n *\n * Key order is fixed here — the reader's own key order, top level and inside `store`\n * and `hooks` — so a re-run diffs cleanly no matter which verb wrote the file, and two\n * writers can never disagree about shape. What goes *into* the config stays each\n * verb's policy: the wizard's choices, and `hooks install`'s directory-store injection.\n * Absent keys are omitted rather than written as `null`, so\n * `parseConfig(renderConfig(c))` returns `c` field for field —\n * `test/guards/config-writer.test.ts` pins that round trip.\n */\nexport function renderConfig(config: SmeltConfig): string {\n  const ordered: SmeltConfig = {\n    smeltConfig: CONFIG_VERSION,\n    ...(config.defaultBudgetBytes === undefined\n      ? {}\n      : { defaultBudgetBytes: config.defaultBudgetBytes }),\n    ...(config.strategy === undefined ? {} : { strategy: config.strategy }),\n    ...(config.store === undefined ? {} : { store: renderStore(config.store) }),\n    ...(config.hooks === undefined ? {} : { hooks: renderHooks(config.hooks) }),\n  };\n  return `${JSON.stringify(ordered, null, 2)}\\n`;\n}\n\nfunction renderStore(store: SmeltConfigStore): SmeltConfigStore {\n  return store.kind === 'memory' ? { kind: 'memory' } : { kind: 'directory', path: store.path };\n}\n\nfunction renderHooks(hooks: SmeltConfigHooks): SmeltConfigHooks {\n  return {\n    ...(hooks.thresholdBytes === undefined ? {} : { thresholdBytes: hooks.thresholdBytes }),\n    ...(hooks.enforcement === undefined ? {} : { enforcement: hooks.enforcement }),\n  };\n}\n\nfunction parseStore(\n  value: unknown,\n  bad: (why: string) => CliUsageError,\n): SmeltConfigStore | undefined {\n  if (value === undefined) return undefined;\n  if (typeof value !== 'object' || value === null || Array.isArray(value)) {\n    throw bad(`\"store\" must be an object like {\"kind\":\"memory\"} or {\"kind\":\"directory\",\"path\":…}.`);\n  }\n  const fields = value as Record<string, unknown>;\n  const kind = fields['kind'];\n  if (kind === 'memory') {\n    const extra = Object.keys(fields).filter((key) => key !== 'kind');\n    if (extra.length > 0) throw bad(`\"store\" of kind \"memory\" takes no other keys.`);\n    return { kind: 'memory' };\n  }\n  if (kind === 'directory') {\n    const path = fields['path'];\n    if (typeof path !== 'string' || path === '') {\n      throw bad(`\"store\" of kind \"directory\" needs a non-empty \"path\".`);\n    }\n    const extra = Object.keys(fields).filter((key) => key !== 'kind' && key !== 'path');\n    if (extra.length > 0) throw bad(`\"store\" of kind \"directory\" takes only \"kind\" and \"path\".`);\n    return { kind: 'directory', path };\n  }\n  throw bad(`\"store\".kind must be \"memory\" or \"directory\", got ${JSON.stringify(kind)}.`);\n}\n\nfunction parseHooks(\n  value: unknown,\n  bad: (why: string) => CliUsageError,\n): SmeltConfigHooks | undefined {\n  if (value === undefined) return undefined;\n  if (typeof value !== 'object' || value === null || Array.isArray(value)) {\n    throw bad(`\"hooks\" must be an object like {\"thresholdBytes\":8192,\"enforcement\":\"deny\"}.`);\n  }\n  const fields = value as Record<string, unknown>;\n  const extra = Object.keys(fields).filter(\n    (key) => key !== 'thresholdBytes' && key !== 'enforcement',\n  );\n  if (extra.length > 0) {\n    throw bad(\n      `\"hooks\" takes only \"thresholdBytes\" and \"enforcement\", ` +\n        `got ${extra.map((k) => `\"${k}\"`).join(', ')}.`,\n    );\n  }\n  const threshold = fields['thresholdBytes'];\n  if (\n    threshold !== undefined &&\n    (typeof threshold !== 'number' || !Number.isInteger(threshold) || threshold <= 0)\n  ) {\n    throw bad(`\"hooks\".thresholdBytes must be a whole number of bytes greater than zero.`);\n  }\n  const enforcement = fields['enforcement'];\n  if (\n    enforcement !== undefined &&\n    !(ENFORCEMENT_MODES as readonly unknown[]).includes(enforcement)\n  ) {\n    throw bad(\n      `\"hooks\".enforcement must be ${ENFORCEMENT_MODES.map((m) => `\"${m}\"`).join(' or ')}, ` +\n        `got ${JSON.stringify(enforcement)}.`,\n    );\n  }\n  return {\n    ...(threshold === undefined ? {} : { thresholdBytes: threshold as number }),\n    ...(enforcement === undefined ? {} : { enforcement: enforcement as EnforcementMode }),\n  };\n}\n\n/** `store.path` is relative to the config file, so the config works from any cwd. */\nexport function resolveStorePath(loaded: LoadedConfig, path: string): string {\n  return resolve(dirname(loaded.path), path);\n}\n\n/**\n * The store decision a config carries, with `path` already resolved against the config\n * file's directory — one config serves every subdirectory it covers without scattering\n * store roots. `'memory'` is the built-in default: a fresh in-memory store per run.\n */\nexport type ConfiguredStore =\n  { readonly kind: 'memory' } | { readonly kind: 'directory'; readonly path: string };\n\n/**\n * The store leg of every merge, read once here rather than in each verb that needs it.\n *\n * There is no store flag, so this leg is config-or-built-in only — which is exactly\n * why it belongs to the config module and not to a verb: `smelt` builds a store from\n * it, and `retrieve`/`stats` refuse when it is not a directory (see `resolveStoreRun`\n * in `subcommands/retrieve.ts`). Three verbs, one reading of the same key.\n */\nexport function configuredStore(config: LoadedConfig | undefined): ConfiguredStore {\n  if (config?.config.store === undefined || config.config.store.kind === 'memory') {\n    return { kind: 'memory' };\n  }\n  return { kind: 'directory', path: resolveStorePath(config, config.config.store.path) };\n}\n"]}