@smeltjs/core 0.3.0 → 0.4.0

package/dist/cli/agents.js

@@ -0,0 +1,121 @@
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
+import { dirname, join, resolve } from 'node:path';
+import { GUIDE_URL } from '../agents/guide.js';
+import { readInstructionSet } from '../agents/instructions.js';
+import { planSplit, refactorPrompt, splitSeamNotice } from '../agents/split.js';
+import { CliUsageError } from '../errors.js';
+import { readTree } from '../ops/inputs.js';
+import { answerReader, CLI_NAME } from './shell.js';
+/**
+ * One `smelt agents split` run, start to finish. Returns an exit code, never calls
+ * `exit` — the same testability shape as `runInit` and `runHooks`.
+ *
+ * @throws {CliUsageError} when the directory cannot be read, when there is no
+ *   instruction file to split, or when input ends mid-wizard. A refusal, never a guess:
+ *   splitting a file smelt had to invent would be the auto-generation the guide rules
+ *   out, and a missing directory reported as an internal error would be smelt blaming
+ *   itself for a typo.
+ */
+export async function runAgentsSplit(io) {
+    // `resolve`, not `join`: an absolute `dir` is the user's answer, and concatenating
+    // the working directory onto it invents a path nobody named. Then the same tree
+    // ruling `agents lint` uses — a directory that is not there is a refusal naming it,
+    // not an ENOENT escaping as "unexpected internal error" with a stack trace.
+    const root = resolve(io.cwd, io.dir);
+    const tree = readTree(root, io.dir, { tree: 'agents split', file: `\`${CLI_NAME} <file>\`` });
+    if (!tree.ok)
+        throw new CliUsageError(`${CLI_NAME}: ${tree.refusal}`);
+    const set = readInstructionSet({ root });
+    const rootLevel = set.levels.find((level) => level.dir === '');
+    if (rootLevel === undefined) {
+        throw new CliUsageError(`${CLI_NAME} agents split: no AGENTS.md, CLAUDE.md or GEMINI.md at ${io.dir}. ` +
+            `There is nothing to split, and ${CLI_NAME} will not write one for you — ` +
+            `the guide it follows says never to auto-generate an AGENTS.md (${GUIDE_URL}).`);
+    }
+    const file = rootLevel.primary;
+    const plan = planSplit(file);
+    io.output(`${CLI_NAME} agents split — the mechanical half of the guide's refactor.\n` +
+        `Nothing is written until you confirm, and an existing file is never overwritten\n` +
+        `without its own yes.\n\n`);
+    if (plan.refusal !== undefined) {
+        io.output(`  ${plan.refusal}\n\n`);
+        return 0;
+    }
+    io.output(`${plan.source}: ${String(plan.beforeBytes)} bytes, ` +
+        `${String(plan.sections.length)} \`##\` section${plan.sections.length === 1 ? '' : 's'}.\n` +
+        `The root file would become ${String(plan.afterBytes)} bytes — everything above the\n` +
+        `first heading, plus a link to each moved section.\n\n`);
+    const lines = answerReader(io.input);
+    const ask = async (prompt) => {
+        io.output(prompt);
+        const next = await lines.next();
+        if (next === undefined) {
+            throw new CliUsageError(`${CLI_NAME} agents split: input ended before the wizard finished. ` +
+                `Files already confirmed and written stay; nothing further was written.`);
+        }
+        return next.trim();
+    };
+    try {
+        await confirmAndWrite(io, ask, root, plan);
+    }
+    finally {
+        await lines.release();
+    }
+    // Printed whether or not anything was written: the prompt is the half of the
+    // refactor smelt refused to do, and refusing the writes does not make it less true.
+    io.output(`\n${refactorPrompt(plan)}\n`);
+    io.output(`${splitSeamNotice()}\n`);
+    return 0;
+}
+function planned(root, name, content) {
+    const path = join(root, name);
+    const exists = existsSync(path);
+    return {
+        name,
+        path,
+        content,
+        exists,
+        unchanged: exists && readFileSync(path, 'utf8') === content,
+    };
+}
+const fileLabel = (file) => {
+    if (file.unchanged)
+        return 'unchanged — nothing to write';
+    return file.exists ? 'exists — will ask before overwriting' : 'new';
+};
+async function confirmAndWrite(io, ask, root, plan) {
+    const files = plan.files.map((file) => planned(root, file.path, file.content));
+    io.output(`About to write, into ${root}:\n` +
+        files.map((file) => `  ${file.name.padEnd(40)} (${fileLabel(file)})\n`).join('') +
+        `Nothing has been written yet.\n`);
+    for (;;) {
+        const answer = await ask(`confirm (yes / no)> `);
+        if (answer === 'no') {
+            io.output(`Nothing was written.\n`);
+            return;
+        }
+        if (answer === 'yes')
+            break;
+        io.output(`yes to write, no to leave everything untouched.\n`);
+    }
+    for (const file of files) {
+        if (file.unchanged) {
+            io.output(`  ${file.name} — unchanged, not rewritten\n`);
+            continue;
+        }
+        if (file.exists) {
+            // The one hard rule, same as `smelt init` and `smelt hooks`: an existing file is
+            // never touched without an explicit per-file yes — not `y`, not Enter, a literal
+            // `yes`. The root instruction file is *always* on this branch, by construction.
+            const answer = await ask(`  ${file.name} exists — overwrite it? (yes/no)> `);
+            if (answer !== 'yes') {
+                io.output(`  skipped ${file.name} — the existing file was not touched\n`);
+                continue;
+            }
+        }
+        mkdirSync(dirname(file.path), { recursive: true });
+        writeFileSync(file.path, file.content);
+        io.output(`  wrote ${file.name}\n`);
+    }
+}
+//# sourceMappingURL=agents.js.map

package/dist/cli/agents.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agents.js","sourceRoot":"","sources":["../../src/cli/agents.ts"],"names":[],"mappings":"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","sourcesContent":["import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';\nimport { dirname, join, resolve } from 'node:path';\n\nimport { GUIDE_URL } from '../agents/guide.ts';\nimport { readInstructionSet } from '../agents/instructions.ts';\nimport type { InstructionFile } from '../agents/instructions.ts';\nimport { planSplit, refactorPrompt, splitSeamNotice } from '../agents/split.ts';\nimport type { SplitPlan } from '../agents/split.ts';\nimport { CliUsageError } from '../errors.ts';\nimport { readTree } from '../ops/inputs.ts';\n\nimport { answerReader, CLI_NAME } from './shell.ts';\nimport type { AnswerStream } from './shell.ts';\n\n/**\n * `smelt agents split` — the wizard, and nothing else.\n *\n * The partition, the link rewrite and the refactor prompt are `src/agents/split.ts`,\n * which is strings in, strings out and knows nothing about a terminal. What lives here\n * is the half that touches disk, and it is `smelt init`'s discipline verbatim, for the\n * reason stated in `cli/hooks.ts`: this command rewrites a file somebody wrote by hand,\n * and a hand-written AGENTS.md clobbered by a tool is somebody's day gone.\n *\n *   - every file listed, with `new` / `exists` / `unchanged`, before anything is written;\n *   - one final `yes`;\n *   - an existing file overwritten only after its **own** literal `yes` — not `y`, not\n *     Enter;\n *   - the guide's refactor prompt printed either way, because the judgment half is\n *     what the user actually came for and refusing the writes does not change that.\n */\n\n/** Where the split wizard's bytes come from and go. Injected, so it tests in-process. */\nexport interface AgentsSplitIo {\n  /** Scripted answers in, one line at a time. See {@link AnswerStream}. */\n  readonly input: AnswerStream;\n  readonly output: (text: string) => void;\n  /** The working directory; every write is relative to `dir` resolved against it. */\n  readonly cwd: string;\n  /** The directory to split, as typed. `'.'` by default. */\n  readonly dir: string;\n}\n\n/**\n * One `smelt agents split` run, start to finish. Returns an exit code, never calls\n * `exit` — the same testability shape as `runInit` and `runHooks`.\n *\n * @throws {CliUsageError} when the directory cannot be read, when there is no\n *   instruction file to split, or when input ends mid-wizard. A refusal, never a guess:\n *   splitting a file smelt had to invent would be the auto-generation the guide rules\n *   out, and a missing directory reported as an internal error would be smelt blaming\n *   itself for a typo.\n */\nexport async function runAgentsSplit(io: AgentsSplitIo): Promise<number> {\n  // `resolve`, not `join`: an absolute `dir` is the user's answer, and concatenating\n  // the working directory onto it invents a path nobody named. Then the same tree\n  // ruling `agents lint` uses — a directory that is not there is a refusal naming it,\n  // not an ENOENT escaping as \"unexpected internal error\" with a stack trace.\n  const root = resolve(io.cwd, io.dir);\n  const tree = readTree(root, io.dir, { tree: 'agents split', file: `\\`${CLI_NAME} <file>\\`` });\n  if (!tree.ok) throw new CliUsageError(`${CLI_NAME}: ${tree.refusal}`);\n\n  const set = readInstructionSet({ root });\n  const rootLevel = set.levels.find((level) => level.dir === '');\n\n  if (rootLevel === undefined) {\n    throw new CliUsageError(\n      `${CLI_NAME} agents split: no AGENTS.md, CLAUDE.md or GEMINI.md at ${io.dir}. ` +\n        `There is nothing to split, and ${CLI_NAME} will not write one for you — ` +\n        `the guide it follows says never to auto-generate an AGENTS.md (${GUIDE_URL}).`,\n    );\n  }\n\n  const file: InstructionFile = rootLevel.primary;\n  const plan = planSplit(file);\n\n  io.output(\n    `${CLI_NAME} agents split — the mechanical half of the guide's refactor.\\n` +\n      `Nothing is written until you confirm, and an existing file is never overwritten\\n` +\n      `without its own yes.\\n\\n`,\n  );\n\n  if (plan.refusal !== undefined) {\n    io.output(`  ${plan.refusal}\\n\\n`);\n    return 0;\n  }\n\n  io.output(\n    `${plan.source}: ${String(plan.beforeBytes)} bytes, ` +\n      `${String(plan.sections.length)} \\`##\\` section${plan.sections.length === 1 ? '' : 's'}.\\n` +\n      `The root file would become ${String(plan.afterBytes)} bytes — everything above the\\n` +\n      `first heading, plus a link to each moved section.\\n\\n`,\n  );\n\n  const lines = answerReader(io.input);\n  const ask = async (prompt: string): Promise<string> => {\n    io.output(prompt);\n    const next = await lines.next();\n    if (next === undefined) {\n      throw new CliUsageError(\n        `${CLI_NAME} agents split: input ended before the wizard finished. ` +\n          `Files already confirmed and written stay; nothing further was written.`,\n      );\n    }\n    return next.trim();\n  };\n\n  try {\n    await confirmAndWrite(io, ask, root, plan);\n  } finally {\n    await lines.release();\n  }\n\n  // Printed whether or not anything was written: the prompt is the half of the\n  // refactor smelt refused to do, and refusing the writes does not make it less true.\n  io.output(`\\n${refactorPrompt(plan)}\\n`);\n  io.output(`${splitSeamNotice()}\\n`);\n  return 0;\n}\n\n/** A file the split would write, checked against what is on disk right now. */\ninterface PlannedSplitFile {\n  readonly name: string;\n  readonly path: string;\n  readonly content: string;\n  readonly exists: boolean;\n  readonly unchanged: boolean;\n}\n\nfunction planned(root: string, name: string, content: string): PlannedSplitFile {\n  const path = join(root, name);\n  const exists = existsSync(path);\n  return {\n    name,\n    path,\n    content,\n    exists,\n    unchanged: exists && readFileSync(path, 'utf8') === content,\n  };\n}\n\nconst fileLabel = (file: PlannedSplitFile): string => {\n  if (file.unchanged) return 'unchanged — nothing to write';\n  return file.exists ? 'exists — will ask before overwriting' : 'new';\n};\n\nasync function confirmAndWrite(\n  io: AgentsSplitIo,\n  ask: (prompt: string) => Promise<string>,\n  root: string,\n  plan: SplitPlan,\n): Promise<void> {\n  const files = plan.files.map((file) => planned(root, file.path, file.content));\n\n  io.output(\n    `About to write, into ${root}:\\n` +\n      files.map((file) => `  ${file.name.padEnd(40)} (${fileLabel(file)})\\n`).join('') +\n      `Nothing has been written yet.\\n`,\n  );\n\n  for (;;) {\n    const answer = await ask(`confirm (yes / no)> `);\n    if (answer === 'no') {\n      io.output(`Nothing was written.\\n`);\n      return;\n    }\n    if (answer === 'yes') break;\n    io.output(`yes to write, no to leave everything untouched.\\n`);\n  }\n\n  for (const file of files) {\n    if (file.unchanged) {\n      io.output(`  ${file.name} — unchanged, not rewritten\\n`);\n      continue;\n    }\n    if (file.exists) {\n      // The one hard rule, same as `smelt init` and `smelt hooks`: an existing file is\n      // never touched without an explicit per-file yes — not `y`, not Enter, a literal\n      // `yes`. The root instruction file is *always* on this branch, by construction.\n      const answer = await ask(`  ${file.name} exists — overwrite it? (yes/no)> `);\n      if (answer !== 'yes') {\n        io.output(`  skipped ${file.name} — the existing file was not touched\\n`);\n        continue;\n      }\n    }\n    mkdirSync(dirname(file.path), { recursive: true });\n    writeFileSync(file.path, file.content);\n    io.output(`  wrote ${file.name}\\n`);\n  }\n}\n"]}

package/dist/cli/args.d.ts

@@ -1,6 +1,7 @@
 export { CLI_NAME } from './shell.ts';
 export { cliUsage } from './usage.ts';
 export type { CliInvocation } from './subcommands/registry.ts';
+export type { AgentsInvocation } from './subcommands/agents.ts';
 export type { HooksInvocation } from './subcommands/hooks.ts';
 export type { InitInvocation } from './subcommands/init.ts';
 export type { MapInvocation } from './subcommands/map.ts';

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

@@ -1 +1 @@
-{"version":3,"file":"args.d.ts","sourceRoot":"","sources":["../../src/cli/args.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,YAAY,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAC/D,YAAY,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAC9D,YAAY,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAC5D,YAAY,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAC1D,YAAY,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AACpE,YAAY,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAC9D,YAAY,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAE9D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAE/D;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,aAAa,CA0BrE","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"]}
+{"version":3,"file":"args.d.ts","sourceRoot":"","sources":["../../src/cli/args.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,YAAY,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAC/D,YAAY,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAChE,YAAY,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAC9D,YAAY,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAC5D,YAAY,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAC1D,YAAY,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AACpE,YAAY,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAC9D,YAAY,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAE9D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAE/D;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,aAAa,CA0BrE","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 { AgentsInvocation } from './subcommands/agents.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/args.js.map

@@ -1 +1 @@
-{"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"]}
+{"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;AAYtC;;;;;;;;;;;;;;;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 { AgentsInvocation } from './subcommands/agents.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/config.d.ts

@@ -47,6 +47,24 @@ export interface SmeltConfigHooks {
      */
     readonly enforcement?: EnforcementMode;
 }
+/**
+ * The `agents` block — settings for `smelt agents lint`.
+ *
+ * One key, and it is the user's number: how many UTF-8 bytes of instruction file this
+ * project is willing to pay on every request. **There is no default and there never
+ * will be** — the same ruling as `--budget`, for the same reason. A budget smelt
+ * invented would be smelt deciding how much of somebody's context window their own
+ * house rules deserve, at a number nobody chose. The guide's cited "~150-200
+ * instructions" figure is printed by the lint as a citation and compared to nothing.
+ */
+export interface SmeltConfigAgents {
+    /**
+     * The merged set's byte ceiling — every `AGENTS.md`/`CLAUDE.md`/`GEMINI.md` in the
+     * tree, summed. Absent means unbudgeted: the lint measures and reports, and no
+     * number can fail.
+     */
+    readonly budgetBytes?: number;
+}
 /** The parsed shape of `smelt.config.json`. Every field beyond the version is optional. */
 export interface SmeltConfig {
     readonly smeltConfig: typeof CONFIG_VERSION;
@@ -58,6 +76,8 @@ export interface SmeltConfig {
     readonly store?: SmeltConfigStore;
     /** Settings for the harness guard. See {@link SmeltConfigHooks}. */
     readonly hooks?: SmeltConfigHooks;
+    /** Settings for `smelt agents lint`. See {@link SmeltConfigAgents}. */
+    readonly agents?: SmeltConfigAgents;
 }
 /** A config plus where it was found — the path matters for resolving `store.path`. */
 export interface LoadedConfig {

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,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"]}
+{"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;;;;;;;;;GASG;AACH,MAAM,WAAW,iBAAiB;IAChC;;;;OAIG;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;CAC/B;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;IAClC,uEAAuE;IACvE,QAAQ,CAAC,MAAM,CAAC,EAAE,iBAAiB,CAAC;CACrC;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,CAiEnE;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,WAAW,GAAG,MAAM,CAYxD;AAqHD,qFAAqF;AACrF,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAE3E;AACD;;;;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/**\n * The `agents` block — settings for `smelt agents lint`.\n *\n * One key, and it is the user's number: how many UTF-8 bytes of instruction file this\n * project is willing to pay on every request. **There is no default and there never\n * will be** — the same ruling as `--budget`, for the same reason. A budget smelt\n * invented would be smelt deciding how much of somebody's context window their own\n * house rules deserve, at a number nobody chose. The guide's cited \"~150-200\n * instructions\" figure is printed by the lint as a citation and compared to nothing.\n */\nexport interface SmeltConfigAgents {\n  /**\n   * The merged set's byte ceiling — every `AGENTS.md`/`CLAUDE.md`/`GEMINI.md` in the\n   * tree, summed. Absent means unbudgeted: the lint measures and reports, and no\n   * number can fail.\n   */\n  readonly budgetBytes?: number;\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  /** Settings for `smelt agents lint`. See {@link SmeltConfigAgents}. */\n  readonly agents?: SmeltConfigAgents;\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', 'agents'];\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  const agents = parseAgents(fields['agents'], 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    ...(agents === undefined ? {} : { agents }),\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    ...(config.agents === undefined ? {} : { agents: renderAgents(config.agents) }),\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 renderAgents(agents: SmeltConfigAgents): SmeltConfigAgents {\n  return agents.budgetBytes === undefined ? {} : { budgetBytes: agents.budgetBytes };\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/**\n * The `agents` block, parsed as strictly as every other: one key, a whole number of\n * bytes greater than zero.\n *\n * A malformed `agents.budgetBytes` is refused rather than ignored for the reason the\n * whole file is parsed strictly — an ignored budget is a ceiling the user believed was\n * in force. And there is no coercion from a string: `\"budgetBytes\": \"4kb\"` is a\n * mistake with a right answer, and guessing it would be smelt inventing a number.\n */\nfunction parseAgents(\n  value: unknown,\n  bad: (why: string) => CliUsageError,\n): SmeltConfigAgents | undefined {\n  if (value === undefined) return undefined;\n  if (typeof value !== 'object' || value === null || Array.isArray(value)) {\n    throw bad(`\"agents\" must be an object like {\"budgetBytes\":2000}.`);\n  }\n  const fields = value as Record<string, unknown>;\n  const extra = Object.keys(fields).filter((key) => key !== 'budgetBytes');\n  if (extra.length > 0) {\n    throw bad(`\"agents\" takes only \"budgetBytes\", got ${extra.map((k) => `\"${k}\"`).join(', ')}.`);\n  }\n  const budget = fields['budgetBytes'];\n  if (\n    budget !== undefined &&\n    (typeof budget !== 'number' || !Number.isInteger(budget) || budget <= 0)\n  ) {\n    throw bad(`\"agents\".budgetBytes must be a whole number of bytes greater than zero.`);\n  }\n  return budget === undefined ? {} : { budgetBytes: budget as number };\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 * 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"]}

package/dist/cli/config.js

@@ -85,7 +85,7 @@ export function parseConfig(text, path) {
             `${String(CONFIG_VERSION)}. The schema is versioned so a mismatch is visible ` +
             `instead of half-understood.`);
     }
-    const known = ['smeltConfig', 'defaultBudgetBytes', 'strategy', 'store', 'hooks'];
+    const known = ['smeltConfig', 'defaultBudgetBytes', 'strategy', 'store', 'hooks', 'agents'];
     const unknown = Object.keys(fields).filter((key) => !known.includes(key));
     if (unknown.length > 0) {
         throw bad(`unknown key${unknown.length === 1 ? '' : 's'} ${unknown.map((k) => `"${k}"`).join(', ')}. ` +
@@ -106,12 +106,14 @@ export function parseConfig(text, path) {
     }
     const store = parseStore(fields['store'], bad);
     const hooks = parseHooks(fields['hooks'], bad);
+    const agents = parseAgents(fields['agents'], bad);
     return {
         smeltConfig: CONFIG_VERSION,
         ...(budget === undefined ? {} : { defaultBudgetBytes: budget }),
         ...(strategy === undefined ? {} : { strategy }),
         ...(store === undefined ? {} : { store }),
         ...(hooks === undefined ? {} : { hooks }),
+        ...(agents === undefined ? {} : { agents }),
     };
 }
 /**
@@ -142,6 +144,7 @@ export function renderConfig(config) {
         ...(config.strategy === undefined ? {} : { strategy: config.strategy }),
         ...(config.store === undefined ? {} : { store: renderStore(config.store) }),
         ...(config.hooks === undefined ? {} : { hooks: renderHooks(config.hooks) }),
+        ...(config.agents === undefined ? {} : { agents: renderAgents(config.agents) }),
     };
     return `${JSON.stringify(ordered, null, 2)}\n`;
 }
@@ -154,6 +157,9 @@ function renderHooks(hooks) {
         ...(hooks.enforcement === undefined ? {} : { enforcement: hooks.enforcement }),
     };
 }
+function renderAgents(agents) {
+    return agents.budgetBytes === undefined ? {} : { budgetBytes: agents.budgetBytes };
+}
 function parseStore(value, bad) {
     if (value === undefined)
         return undefined;
@@ -208,6 +214,33 @@ function parseHooks(value, bad) {
         ...(enforcement === undefined ? {} : { enforcement: enforcement }),
     };
 }
+/**
+ * The `agents` block, parsed as strictly as every other: one key, a whole number of
+ * bytes greater than zero.
+ *
+ * A malformed `agents.budgetBytes` is refused rather than ignored for the reason the
+ * whole file is parsed strictly — an ignored budget is a ceiling the user believed was
+ * in force. And there is no coercion from a string: `"budgetBytes": "4kb"` is a
+ * mistake with a right answer, and guessing it would be smelt inventing a number.
+ */
+function parseAgents(value, bad) {
+    if (value === undefined)
+        return undefined;
+    if (typeof value !== 'object' || value === null || Array.isArray(value)) {
+        throw bad(`"agents" must be an object like {"budgetBytes":2000}.`);
+    }
+    const fields = value;
+    const extra = Object.keys(fields).filter((key) => key !== 'budgetBytes');
+    if (extra.length > 0) {
+        throw bad(`"agents" takes only "budgetBytes", got ${extra.map((k) => `"${k}"`).join(', ')}.`);
+    }
+    const budget = fields['budgetBytes'];
+    if (budget !== undefined &&
+        (typeof budget !== 'number' || !Number.isInteger(budget) || budget <= 0)) {
+        throw bad(`"agents".budgetBytes must be a whole number of bytes greater than zero.`);
+    }
+    return budget === undefined ? {} : { budgetBytes: budget };
+}
 /** `store.path` is relative to the config file, so the config works from any cwd. */
 export function resolveStorePath(loaded, path) {
     return resolve(dirname(loaded.path), path);

package/dist/cli/config.js.map

@@ -1 +1 @@
-{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/cli/config.ts"],"names":[],"mappings":"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","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"]}
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/cli/config.ts"],"names":[],"mappings":"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","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/**\n * The `agents` block — settings for `smelt agents lint`.\n *\n * One key, and it is the user's number: how many UTF-8 bytes of instruction file this\n * project is willing to pay on every request. **There is no default and there never\n * will be** — the same ruling as `--budget`, for the same reason. A budget smelt\n * invented would be smelt deciding how much of somebody's context window their own\n * house rules deserve, at a number nobody chose. The guide's cited \"~150-200\n * instructions\" figure is printed by the lint as a citation and compared to nothing.\n */\nexport interface SmeltConfigAgents {\n  /**\n   * The merged set's byte ceiling — every `AGENTS.md`/`CLAUDE.md`/`GEMINI.md` in the\n   * tree, summed. Absent means unbudgeted: the lint measures and reports, and no\n   * number can fail.\n   */\n  readonly budgetBytes?: number;\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  /** Settings for `smelt agents lint`. See {@link SmeltConfigAgents}. */\n  readonly agents?: SmeltConfigAgents;\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', 'agents'];\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  const agents = parseAgents(fields['agents'], 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    ...(agents === undefined ? {} : { agents }),\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    ...(config.agents === undefined ? {} : { agents: renderAgents(config.agents) }),\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 renderAgents(agents: SmeltConfigAgents): SmeltConfigAgents {\n  return agents.budgetBytes === undefined ? {} : { budgetBytes: agents.budgetBytes };\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/**\n * The `agents` block, parsed as strictly as every other: one key, a whole number of\n * bytes greater than zero.\n *\n * A malformed `agents.budgetBytes` is refused rather than ignored for the reason the\n * whole file is parsed strictly — an ignored budget is a ceiling the user believed was\n * in force. And there is no coercion from a string: `\"budgetBytes\": \"4kb\"` is a\n * mistake with a right answer, and guessing it would be smelt inventing a number.\n */\nfunction parseAgents(\n  value: unknown,\n  bad: (why: string) => CliUsageError,\n): SmeltConfigAgents | undefined {\n  if (value === undefined) return undefined;\n  if (typeof value !== 'object' || value === null || Array.isArray(value)) {\n    throw bad(`\"agents\" must be an object like {\"budgetBytes\":2000}.`);\n  }\n  const fields = value as Record<string, unknown>;\n  const extra = Object.keys(fields).filter((key) => key !== 'budgetBytes');\n  if (extra.length > 0) {\n    throw bad(`\"agents\" takes only \"budgetBytes\", got ${extra.map((k) => `\"${k}\"`).join(', ')}.`);\n  }\n  const budget = fields['budgetBytes'];\n  if (\n    budget !== undefined &&\n    (typeof budget !== 'number' || !Number.isInteger(budget) || budget <= 0)\n  ) {\n    throw bad(`\"agents\".budgetBytes must be a whole number of bytes greater than zero.`);\n  }\n  return budget === undefined ? {} : { budgetBytes: budget as number };\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 * 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"]}

package/dist/cli/hooks.d.ts

@@ -14,20 +14,24 @@ import type { SmeltConfig, SmeltConfigHooks } from './config.ts';
  *
  * Every per-harness fact lives in that harness's {@link HarnessProfile}
  * (`src/harness/<id>.ts`), including what to write and how to take it back out. This
- * module owns only what is the *same* for every harness: the byte-faithful JSON merge,
- * the marker-block upsert, the wizard, and the two plans below — folds over
- * `profile.install`, with no case list of its own.
+ * module owns only what is the *same* for every harness: the hooks merge (which entries
+ * are ours, what a re-run replaces), the wizard, and the two plans below — folds over
+ * `profile.install`, with no case list of its own. The byte-faithful editing itself —
+ * one top-level JSON property, one delimited text block — is `src/text/json-edit.ts`,
+ * which knows nothing about harnesses.
  *
- * Harnesses come in three honesty tiers (docs/research/2026-09-02-harness-capability-matrix.md):
+ * Harnesses come in three honesty tiers (docs/research/2026-09-02-harness-capability-matrix.md),
+ * and which harness sits at which is `HarnessProfile.tier` — read through
+ * `harnessesByTier()`, never listed again here:
  *
- *  - **verified** — Claude Code, Codex: schemas verified against primary docs and
- *    exercised against recorded fixtures; first-class targets.
- *  - **experimental** — Gemini, Grok, Hermes, Cursor, opencode, Cline: hook schemas
- *    mapped from the capability matrix but not yet smoke-tested green against the
- *    real binary. Labelled as such in code, docs, and this installer's output.
- *  - **advisory** — KiloCode, Aider: no usable hook API, so what ships is
- *    instructions (and, for KiloCode, a permissions/MCP sketch). Nothing enforces
- *    them, and the output says so rather than implying a guard exists.
+ *  - **verified** — schemas verified against primary docs and exercised against
+ *    recorded fixtures; first-class targets.
+ *  - **experimental** — hook schemas mapped from the capability matrix but not yet
+ *    smoke-tested green against the real binary. Labelled as such in code, docs, and
+ *    this installer's output.
+ *  - **advisory** — no usable hook API, so what ships is instructions (and, for
+ *    KiloCode, a permissions/MCP sketch). Nothing enforces them, and the output says
+ *    so rather than implying a guard exists.
  *
  * The wizard discipline is `smelt init`'s, verbatim: every step accepts `back`,
  * nothing is written until a final confirm that lists every file, and an existing
@@ -51,6 +55,7 @@ export interface HooksIo {
 export { instructionSnippet, SNIPPET_END_MD, SNIPPET_START_MD };
 /** A harness whose config directory exists in the project or the home directory. */
 export declare function detectedHarnesses(cwd: string, home: string): readonly HarnessProfile[];
+export declare const AGENTS_LINT_ARGS = "agents lint .";
 /**
  * Merge our hook entries into a JSON settings file, preserving everything foreign
  * **byte-faithfully**: the merged `hooks` value is spliced into the original text, so
@@ -67,10 +72,6 @@ export declare function detectedHarnesses(cwd: string, home: string): readonly H
 export declare function mergeJsonHooks(existingText: string | undefined, events: Record<string, readonly unknown[]>, shape?: {
     readonly version?: number;
 }): string | undefined;
-/** Replace this installer's marker block in `existingText`, or append it. */
-export declare function upsertMarkerBlock(existingText: string | undefined, block: string, start: string, end: string): string;
-/** Remove the marker block. `undefined` when nothing (or only whitespace) remains. */
-export declare function stripMarkerBlock(existingText: string, start: string, end: string): string | undefined;
 interface PlannedFile {
     /** Display path, relative to the project. */
     readonly name: string;
@@ -97,6 +98,7 @@ export interface HooksChoices {
     guard: boolean;
     statsOnStop: boolean;
     mapOnStart: boolean;
+    lintOnStart: boolean;
     enforcement: EnforcementMode;
     thresholdBytes: number;
 }
@@ -131,6 +133,13 @@ export declare const DEFAULT_STORE_DIR = ".smelt/store";
  * That store injection is this verb's **policy**, which is why it lives here; the
  * bytes are written by `renderConfig` in `config.ts`, the one writer, so a key added
  * to the schema reaches this file and `init`'s together or not at all.
+ *
+ * "Carried verbatim" is spelled as a spread rather than as a list of the fields to
+ * copy, and that is load-bearing: the list version silently dropped every key nobody
+ * remembered to add to it — `agents` was added to the schema and this function kept
+ * writing configs without it, which is a setting the user believed was in force,
+ * caught by `test/guards/config-writer.test.ts`. Only the two fields this verb
+ * actually decides are named.
  */
 export declare function renderConfigWithHooks(existing: SmeltConfig | undefined, hooks: SmeltConfigHooks): string;
 /**