@smeltjs/core 0.3.0 → 0.5.0

package/dist/harness/registry.js

@@ -8,6 +8,7 @@ import { grok } from './grok.js';
 import { hermes } from './hermes.js';
 import { kilocode } from './kilocode.js';
 import { opencode } from './opencode.js';
+import { harnessLabel, HARNESS_TIERS, TIER_HONESTY } from './profile.js';
 /**
  * The registry — every harness smelt knows, one {@link HarnessProfile} each.
  *
@@ -46,18 +47,74 @@ export const HARNESS_IDS = HARNESSES.map((profile) => profile.id);
 export function harnessById(id) {
     return HARNESSES.find((profile) => profile.id === id);
 }
+/**
+ * The tier → harnesses grouping, derived — `HarnessProfile.tier` is data, and this is
+ * the one fold over it.
+ *
+ * It was hand-typed in five places (the `hooks` help body, two wizard sentences, the
+ * README's tier table and the site's), so a harness promoted from experimental to
+ * verified stayed listed under the old tier in four of them and nothing failed: the
+ * only check was that each harness's name appeared *somewhere* in the help. Every
+ * rendered grouping now walks this, and `test/guards/harness-registry.test.ts` asserts
+ * the rendered ones agree with it — each name under its own tier clause and no other.
+ *
+ * Tier order is {@link HARNESS_TIERS} (i.e. `TIER_HONESTY`'s key order); a tier no
+ * profile claims yields no group, because a rendered "advisory ()" is worse than a
+ * tier that has stopped existing.
+ */
+export function harnessesByTier() {
+    return HARNESS_TIERS.map((tier) => ({
+        tier,
+        honesty: TIER_HONESTY[tier],
+        harnesses: HARNESSES.filter((profile) => profile.tier === tier),
+    })).filter((group) => group.harnesses.length > 0);
+}
+/**
+ * Whether this harness's native schema carries the session-lifecycle events this preset
+ * offers — `smelt stats` on Stop, `smelt map` on SessionStart — i.e. whether it declares
+ * a JSON hook step with `lifecycle`.
+ *
+ * The wizard used to call these "verified-tier harnesses (Claude Code, Codex)", which
+ * is a tier standing in for a capability it merely correlates with: the tier is how much
+ * smelt is willing to *claim* about a harness, `lifecycle` is whether the harness has
+ * the events at all. The two sets coincide today, which is precisely why the sentence
+ * read correctly and why nothing could notice it was wrong — so the guard asks this
+ * predicate about a profile whose tier and capability *disagree*, and the mutation runner
+ * swaps one for the other and watches it go red.
+ */
+export function wiresLifecycle(profile) {
+    return profile.install.some((step) => step.kind === 'json-hooks' && step.lifecycle);
+}
+/** The harnesses the stats/map toggles actually wire, in registry order. */
+export function lifecycleHarnesses() {
+    return HARNESSES.filter(wiresLifecycle);
+}
+/** A list of harnesses as prose spells them — the one join, so the four lists agree. */
+export function harnessNames(profiles) {
+    return profiles.map(harnessLabel).join(', ');
+}
 /** Every JSON hook step any profile declares, in registry order. */
 function jsonHookSteps() {
     return HARNESSES.flatMap((profile) => profile.install.filter((step) => step.kind === 'json-hooks'));
 }
 /**
- * The two session-lifecycle hooks this preset offers, named in each harness's schema:
- * `smelt stats` when a turn ends, an opening `smelt map` when a session starts. Only
- * the harnesses whose schema carries these events wire them (`step.lifecycle`), and
- * `cli/hooks.ts` writes the entries under these exact keys — one spelling, so the
- * managed-event list below cannot fall behind what the installer writes.
+ * The session-lifecycle hooks this preset offers, named in each harness's schema:
+ * `smelt stats` when a turn ends, and — sharing one `SessionStart` event — an opening
+ * `smelt map` and a lint of the repository's own instruction files. Only the harnesses
+ * whose schema carries these events wire them (`step.lifecycle`), and `cli/hooks.ts`
+ * writes the entries under these exact keys — one spelling, so the managed-event list
+ * below cannot fall behind what the installer writes.
+ *
+ * `map` and `lint` deliberately name the **same** event. They are two independent
+ * toggles under one key, which is why `cli/hooks.ts` merges their entries into one
+ * array rather than spreading two objects (the second would silently replace the
+ * first) and why a re-run tells them apart by the command each entry runs.
  */
-export const LIFECYCLE_EVENTS = { stats: 'Stop', map: 'SessionStart' };
+export const LIFECYCLE_EVENTS = {
+    stats: 'Stop',
+    map: 'SessionStart',
+    lint: 'SessionStart',
+};
 /**
  * The events this installer manages, across every harness's spelling of them —
  * foreign entries under them are always preserved, and events nobody claims are never

package/dist/harness/registry.js.map

@@ -1 +1 @@
-{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/harness/registry.ts"],"names":[],"mappings":"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","sourcesContent":["import { aider } from './aider.ts';\nimport { claudeCode } from './claude-code.ts';\nimport { cline } from './cline.ts';\nimport { codex } from './codex.ts';\nimport { cursor } from './cursor.ts';\nimport { gemini } from './gemini.ts';\nimport { grok } from './grok.ts';\nimport { hermes } from './hermes.ts';\nimport { kilocode } from './kilocode.ts';\nimport { opencode } from './opencode.ts';\nimport type { HarnessId, HarnessJsonHooks, HarnessProfile } from './profile.ts';\n\n/**\n * The registry — every harness smelt knows, one {@link HarnessProfile} each.\n *\n * `Record<HarnessId, HarnessProfile>` on purpose: adding a `HarnessId` in `profile.ts`\n * without writing its profile is a compile error, so the id list and the facts cannot\n * drift. Every derived view — the `--harness` help list, the wizard's table, the\n * managed event names, the files a re-run reads its toggles back from — is computed\n * from this object, never written twice.\n *\n * This module imports **nothing from `cli/`**. That is the point: the registry used to\n * live in `cli/hooks.ts`, which imports `CLI_NAME` from `cli/args.ts`, so `args.ts`\n * could not import it back and the `--harness` help list was hand-typed five lines\n * below two lists that were correctly derived.\n *\n * Key order is meaningful: it is the order every rendered harness list uses (the help\n * text, the wizard's table, the \"Known: …\" of an unknown-harness error), so keep it\n * stable and append new harnesses at the end.\n */\nexport const HARNESS_PROFILES: Readonly<Record<HarnessId, HarnessProfile>> = {\n  'claude-code': claudeCode,\n  codex,\n  gemini,\n  grok,\n  hermes,\n  cursor,\n  opencode,\n  cline,\n  kilocode,\n  aider,\n};\n\n/** Every profile, in registry order. The list every rendered table walks. */\nexport const HARNESSES: readonly HarnessProfile[] = Object.values(HARNESS_PROFILES);\n\n/** Every harness id, in registry order — the `--harness` help list, derived. */\nexport const HARNESS_IDS: readonly HarnessId[] = HARNESSES.map((profile) => profile.id);\n\n/** The profile for a harness id, or `undefined` for a string the user made up. */\nexport function harnessById(id: string): HarnessProfile | undefined {\n  return HARNESSES.find((profile) => profile.id === id);\n}\n\n/** Every JSON hook step any profile declares, in registry order. */\nfunction jsonHookSteps(): readonly HarnessJsonHooks[] {\n  return HARNESSES.flatMap((profile) =>\n    profile.install.filter((step): step is HarnessJsonHooks => step.kind === 'json-hooks'),\n  );\n}\n\n/**\n * The two session-lifecycle hooks this preset offers, named in each harness's schema:\n * `smelt stats` when a turn ends, an opening `smelt map` when a session starts. Only\n * the harnesses whose schema carries these events wire them (`step.lifecycle`), and\n * `cli/hooks.ts` writes the entries under these exact keys — one spelling, so the\n * managed-event list below cannot fall behind what the installer writes.\n */\nexport const LIFECYCLE_EVENTS = { stats: 'Stop', map: 'SessionStart' } as const;\n\n/**\n * The events this installer manages, across every harness's spelling of them —\n * foreign entries under them are always preserved, and events nobody claims are never\n * touched. Derived, so a harness that spells its pre-tool event a new way is managed\n * by existing.\n */\nexport const MANAGED_EVENTS: readonly string[] = [\n  ...new Set(\n    jsonHookSteps().flatMap((step) => [\n      step.event,\n      ...(step.lifecycle ? Object.values(LIFECYCLE_EVENTS) : []),\n    ]),\n  ),\n];\n\n/** The managed events that wire the PreToolUse guard, across harness spellings. */\nexport const GUARD_EVENTS: readonly string[] = [\n  ...new Set(jsonHookSteps().map((step) => step.event)),\n];\n\n/** The JSON hook files a re-run reads installed toggles back from, per harness. */\nexport const JSON_HOOK_FILES: readonly string[] = [\n  ...new Set(jsonHookSteps().map((step) => step.file)),\n];\n\n/** Guard-only files whose presence means the guard toggle was installed. */\nexport const GUARD_ONLY_FILES: readonly string[] = [\n  ...new Set(\n    HARNESSES.flatMap((profile) =>\n      profile.install\n        .filter((step) => step.kind === 'own-file' && step.guardOnly)\n        .map((step) => step.file),\n    ),\n  ),\n];\n"]}
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/harness/registry.ts"],"names":[],"mappings":"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","sourcesContent":["import { aider } from './aider.ts';\nimport { claudeCode } from './claude-code.ts';\nimport { cline } from './cline.ts';\nimport { codex } from './codex.ts';\nimport { cursor } from './cursor.ts';\nimport { gemini } from './gemini.ts';\nimport { grok } from './grok.ts';\nimport { hermes } from './hermes.ts';\nimport { kilocode } from './kilocode.ts';\nimport { opencode } from './opencode.ts';\nimport { harnessLabel, HARNESS_TIERS, TIER_HONESTY } from './profile.ts';\nimport type { HarnessId, HarnessJsonHooks, HarnessProfile, HarnessTier } from './profile.ts';\n\n/**\n * The registry — every harness smelt knows, one {@link HarnessProfile} each.\n *\n * `Record<HarnessId, HarnessProfile>` on purpose: adding a `HarnessId` in `profile.ts`\n * without writing its profile is a compile error, so the id list and the facts cannot\n * drift. Every derived view — the `--harness` help list, the wizard's table, the\n * managed event names, the files a re-run reads its toggles back from — is computed\n * from this object, never written twice.\n *\n * This module imports **nothing from `cli/`**. That is the point: the registry used to\n * live in `cli/hooks.ts`, which imports `CLI_NAME` from `cli/args.ts`, so `args.ts`\n * could not import it back and the `--harness` help list was hand-typed five lines\n * below two lists that were correctly derived.\n *\n * Key order is meaningful: it is the order every rendered harness list uses (the help\n * text, the wizard's table, the \"Known: …\" of an unknown-harness error), so keep it\n * stable and append new harnesses at the end.\n */\nexport const HARNESS_PROFILES: Readonly<Record<HarnessId, HarnessProfile>> = {\n  'claude-code': claudeCode,\n  codex,\n  gemini,\n  grok,\n  hermes,\n  cursor,\n  opencode,\n  cline,\n  kilocode,\n  aider,\n};\n\n/** Every profile, in registry order. The list every rendered table walks. */\nexport const HARNESSES: readonly HarnessProfile[] = Object.values(HARNESS_PROFILES);\n\n/** Every harness id, in registry order — the `--harness` help list, derived. */\nexport const HARNESS_IDS: readonly HarnessId[] = HARNESSES.map((profile) => profile.id);\n\n/** The profile for a harness id, or `undefined` for a string the user made up. */\nexport function harnessById(id: string): HarnessProfile | undefined {\n  return HARNESSES.find((profile) => profile.id === id);\n}\n\n/** One tier and the harnesses that ship at it — the row every tier table renders. */\nexport interface HarnessTierGroup {\n  readonly tier: HarnessTier;\n  /** That tier's one line of honesty ({@link TIER_HONESTY}), carried with the group. */\n  readonly honesty: string;\n  /** The profiles at this tier, in registry order. */\n  readonly harnesses: readonly HarnessProfile[];\n}\n\n/**\n * The tier → harnesses grouping, derived — `HarnessProfile.tier` is data, and this is\n * the one fold over it.\n *\n * It was hand-typed in five places (the `hooks` help body, two wizard sentences, the\n * README's tier table and the site's), so a harness promoted from experimental to\n * verified stayed listed under the old tier in four of them and nothing failed: the\n * only check was that each harness's name appeared *somewhere* in the help. Every\n * rendered grouping now walks this, and `test/guards/harness-registry.test.ts` asserts\n * the rendered ones agree with it — each name under its own tier clause and no other.\n *\n * Tier order is {@link HARNESS_TIERS} (i.e. `TIER_HONESTY`'s key order); a tier no\n * profile claims yields no group, because a rendered \"advisory ()\" is worse than a\n * tier that has stopped existing.\n */\nexport function harnessesByTier(): readonly HarnessTierGroup[] {\n  return HARNESS_TIERS.map((tier) => ({\n    tier,\n    honesty: TIER_HONESTY[tier],\n    harnesses: HARNESSES.filter((profile) => profile.tier === tier),\n  })).filter((group) => group.harnesses.length > 0);\n}\n\n/**\n * Whether this harness's native schema carries the session-lifecycle events this preset\n * offers — `smelt stats` on Stop, `smelt map` on SessionStart — i.e. whether it declares\n * a JSON hook step with `lifecycle`.\n *\n * The wizard used to call these \"verified-tier harnesses (Claude Code, Codex)\", which\n * is a tier standing in for a capability it merely correlates with: the tier is how much\n * smelt is willing to *claim* about a harness, `lifecycle` is whether the harness has\n * the events at all. The two sets coincide today, which is precisely why the sentence\n * read correctly and why nothing could notice it was wrong — so the guard asks this\n * predicate about a profile whose tier and capability *disagree*, and the mutation runner\n * swaps one for the other and watches it go red.\n */\nexport function wiresLifecycle(profile: HarnessProfile): boolean {\n  return profile.install.some((step) => step.kind === 'json-hooks' && step.lifecycle);\n}\n\n/** The harnesses the stats/map toggles actually wire, in registry order. */\nexport function lifecycleHarnesses(): readonly HarnessProfile[] {\n  return HARNESSES.filter(wiresLifecycle);\n}\n\n/** A list of harnesses as prose spells them — the one join, so the four lists agree. */\nexport function harnessNames(profiles: readonly HarnessProfile[]): string {\n  return profiles.map(harnessLabel).join(', ');\n}\n\n/** Every JSON hook step any profile declares, in registry order. */\nfunction jsonHookSteps(): readonly HarnessJsonHooks[] {\n  return HARNESSES.flatMap((profile) =>\n    profile.install.filter((step): step is HarnessJsonHooks => step.kind === 'json-hooks'),\n  );\n}\n\n/**\n * The session-lifecycle hooks this preset offers, named in each harness's schema:\n * `smelt stats` when a turn ends, and — sharing one `SessionStart` event — an opening\n * `smelt map` and a lint of the repository's own instruction files. Only the harnesses\n * whose schema carries these events wire them (`step.lifecycle`), and `cli/hooks.ts`\n * writes the entries under these exact keys — one spelling, so the managed-event list\n * below cannot fall behind what the installer writes.\n *\n * `map` and `lint` deliberately name the **same** event. They are two independent\n * toggles under one key, which is why `cli/hooks.ts` merges their entries into one\n * array rather than spreading two objects (the second would silently replace the\n * first) and why a re-run tells them apart by the command each entry runs.\n */\nexport const LIFECYCLE_EVENTS = {\n  stats: 'Stop',\n  map: 'SessionStart',\n  lint: 'SessionStart',\n} as const;\n\n/**\n * The events this installer manages, across every harness's spelling of them —\n * foreign entries under them are always preserved, and events nobody claims are never\n * touched. Derived, so a harness that spells its pre-tool event a new way is managed\n * by existing.\n */\nexport const MANAGED_EVENTS: readonly string[] = [\n  ...new Set(\n    jsonHookSteps().flatMap((step) => [\n      step.event,\n      ...(step.lifecycle ? Object.values(LIFECYCLE_EVENTS) : []),\n    ]),\n  ),\n];\n\n/** The managed events that wire the PreToolUse guard, across harness spellings. */\nexport const GUARD_EVENTS: readonly string[] = [\n  ...new Set(jsonHookSteps().map((step) => step.event)),\n];\n\n/** The JSON hook files a re-run reads installed toggles back from, per harness. */\nexport const JSON_HOOK_FILES: readonly string[] = [\n  ...new Set(jsonHookSteps().map((step) => step.file)),\n];\n\n/** Guard-only files whose presence means the guard toggle was installed. */\nexport const GUARD_ONLY_FILES: readonly string[] = [\n  ...new Set(\n    HARNESSES.flatMap((profile) =>\n      profile.install\n        .filter((step) => step.kind === 'own-file' && step.guardOnly)\n        .map((step) => step.file),\n    ),\n  ),\n];\n"]}

package/dist/harness/snippet.d.ts

@@ -10,10 +10,23 @@ export declare const SNIPPET_START_HASH = "# smelt:hooks v1 start";
 export declare const SNIPPET_END_HASH = "# smelt:hooks v1 end";
 /** Substring that identifies a file (or JSON hook entry) as written by this installer. */
 export declare const OURS_TOKEN = "smelt:hooks";
+/**
+ * The version stamp, as the block's second line: which release wrote these bytes.
+ * The markers above stay byte-stable across releases — an upgrade must find the old
+ * block to replace it — so the version travels *inside* the block, where replacing
+ * the block replaces it. `smelt doctor` reads it back with {@link snippetStampVersion};
+ * a block without the line was written before stamping existed, and doctor says so
+ * instead of guessing a version nobody recorded.
+ */
+export declare const SNIPPET_STAMP_LINE: (version: string) => string;
+/** The version a block was written by, or `undefined` when it predates stamping. */
+export declare function snippetStampVersion(text: string): string | undefined;
 /**
  * The instruction snippet — belt and braces under every shim, and the *only* layer
  * for advisory harnesses. It teaches the three commands, and in particular what to do
  * after a guard deny: run the named replacement, then `smelt retrieve` per marker.
+ * `writtenBy` stamps the block for `smelt doctor`; omitted (legacy callers) the block
+ * simply carries no version line.
  */
-export declare function instructionSnippet(thresholdBytes: number, budgetBytes: number): string;
+export declare function instructionSnippet(thresholdBytes: number, budgetBytes: number, writtenBy?: string): string;
 //# sourceMappingURL=snippet.d.ts.map

package/dist/harness/snippet.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"snippet.d.ts","sourceRoot":"","sources":["../../src/harness/snippet.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,oFAAoF;AACpF,eAAO,MAAM,gBAAgB,kCAAkC,CAAC;AAChE,eAAO,MAAM,cAAc,gCAAgC,CAAC;AAC5D,eAAO,MAAM,kBAAkB,2BAA2B,CAAC;AAC3D,eAAO,MAAM,gBAAgB,yBAAyB,CAAC;AAEvD,0FAA0F;AAC1F,eAAO,MAAM,UAAU,gBAAgB,CAAC;AAExC;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,cAAc,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,CAsBtF","sourcesContent":["/**\n * The text every harness shares: the marker lines that bracket a block this installer\n * owns inside somebody else's file, the token that identifies a hook entry as ours,\n * and the instruction snippet itself.\n */\n\n/** Marker lines bracketing every block this installer owns inside a shared file. */\nexport const SNIPPET_START_MD = '<!-- smelt:hooks v1 start -->';\nexport const SNIPPET_END_MD = '<!-- smelt:hooks v1 end -->';\nexport const SNIPPET_START_HASH = '# smelt:hooks v1 start';\nexport const SNIPPET_END_HASH = '# smelt:hooks v1 end';\n\n/** Substring that identifies a file (or JSON hook entry) as written by this installer. */\nexport const OURS_TOKEN = 'smelt:hooks';\n\n/**\n * The instruction snippet — belt and braces under every shim, and the *only* layer\n * for advisory harnesses. It teaches the three commands, and in particular what to do\n * after a guard deny: run the named replacement, then `smelt retrieve` per marker.\n */\nexport function instructionSnippet(thresholdBytes: number, budgetBytes: number): string {\n  return `${SNIPPET_START_MD}\n\n## smelt — context discipline\n\nThis project uses [smelt](https://github.com/smeltjs/smelt) to keep large tool output\nout of the context window, reversibly.\n\n- Do not read files over ${String(thresholdBytes)} bytes raw. Run\n  \\`smelt <file> --budget ${String(budgetBytes)} --focus <what you are looking for>\\`\n  instead (repeat \\`--focus\\` per term). Focused regions survive verbatim; everything\n  else collapses into a one-line marker stating what was removed.\n- Every marker ends in \\`retrieve(\"hash\")\\`. \\`smelt retrieve <hash>\\` prints the\n  exact original bytes back. Retrieve what you actually need — retrievals are counted,\n  and \\`smelt stats\\` reports the honest expansion rate.\n- For orientation, \\`smelt map . --budget ${String(budgetBytes)}\\` prints a ranked\n  symbol map of the repository.\n- If a smelt guard hook denies a raw read, run the exact replacement command named in\n  the denial, then \\`smelt retrieve\\` any marker you need expanded.\n\n${SNIPPET_END_MD}\n`;\n}\n"]}
+{"version":3,"file":"snippet.d.ts","sourceRoot":"","sources":["../../src/harness/snippet.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,oFAAoF;AACpF,eAAO,MAAM,gBAAgB,kCAAkC,CAAC;AAChE,eAAO,MAAM,cAAc,gCAAgC,CAAC;AAC5D,eAAO,MAAM,kBAAkB,2BAA2B,CAAC;AAC3D,eAAO,MAAM,gBAAgB,yBAAyB,CAAC;AAEvD,0FAA0F;AAC1F,eAAO,MAAM,UAAU,gBAAgB,CAAC;AAExC;;;;;;;GAOG;AACH,eAAO,MAAM,kBAAkB,YAAa,MAAM,KAAG,MACO,CAAC;AAE7D,oFAAoF;AACpF,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAIpE;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAChC,cAAc,EAAE,MAAM,EACtB,WAAW,EAAE,MAAM,EACnB,SAAS,CAAC,EAAE,MAAM,GACjB,MAAM,CAuBR","sourcesContent":["/**\n * The text every harness shares: the marker lines that bracket a block this installer\n * owns inside somebody else's file, the token that identifies a hook entry as ours,\n * and the instruction snippet itself.\n */\n\n/** Marker lines bracketing every block this installer owns inside a shared file. */\nexport const SNIPPET_START_MD = '<!-- smelt:hooks v1 start -->';\nexport const SNIPPET_END_MD = '<!-- smelt:hooks v1 end -->';\nexport const SNIPPET_START_HASH = '# smelt:hooks v1 start';\nexport const SNIPPET_END_HASH = '# smelt:hooks v1 end';\n\n/** Substring that identifies a file (or JSON hook entry) as written by this installer. */\nexport const OURS_TOKEN = 'smelt:hooks';\n\n/**\n * The version stamp, as the block's second line: which release wrote these bytes.\n * The markers above stay byte-stable across releases — an upgrade must find the old\n * block to replace it — so the version travels *inside* the block, where replacing\n * the block replaces it. `smelt doctor` reads it back with {@link snippetStampVersion};\n * a block without the line was written before stamping existed, and doctor says so\n * instead of guessing a version nobody recorded.\n */\nexport const SNIPPET_STAMP_LINE = (version: string): string =>\n  `<!-- smelt:hooks written-by @smeltjs/core ${version} -->`;\n\n/** The version a block was written by, or `undefined` when it predates stamping. */\nexport function snippetStampVersion(text: string): string | undefined {\n  return /<!-- smelt:hooks written-by @smeltjs\\/core (\\d+\\.\\d+\\.\\d+)(?:[-+][^>]*)? -->/u.exec(\n    text,\n  )?.[1];\n}\n\n/**\n * The instruction snippet — belt and braces under every shim, and the *only* layer\n * for advisory harnesses. It teaches the three commands, and in particular what to do\n * after a guard deny: run the named replacement, then `smelt retrieve` per marker.\n * `writtenBy` stamps the block for `smelt doctor`; omitted (legacy callers) the block\n * simply carries no version line.\n */\nexport function instructionSnippet(\n  thresholdBytes: number,\n  budgetBytes: number,\n  writtenBy?: string,\n): string {\n  const stamp = writtenBy === undefined ? '' : `${SNIPPET_STAMP_LINE(writtenBy)}\\n`;\n  return `${SNIPPET_START_MD}\n${stamp}\n## smelt — context discipline\n\nThis project uses [smelt](https://github.com/smeltjs/smelt) to keep large tool output\nout of the context window, reversibly.\n\n- Do not read files over ${String(thresholdBytes)} bytes raw. Run\n  \\`smelt <file> --budget ${String(budgetBytes)} --focus <what you are looking for>\\`\n  instead (repeat \\`--focus\\` per term). Focused regions survive verbatim; everything\n  else collapses into a one-line marker stating what was removed.\n- Every marker ends in \\`retrieve(\"hash\")\\`. \\`smelt retrieve <hash>\\` prints the\n  exact original bytes back. Retrieve what you actually need — retrievals are counted,\n  and \\`smelt stats\\` reports the honest expansion rate.\n- For orientation, \\`smelt map . --budget ${String(budgetBytes)}\\` prints a ranked\n  symbol map of the repository.\n- If a smelt guard hook denies a raw read, run the exact replacement command named in\n  the denial, then \\`smelt retrieve\\` any marker you need expanded.\n\n${SNIPPET_END_MD}\n`;\n}\n"]}

package/dist/harness/snippet.js

@@ -10,14 +10,30 @@ export const SNIPPET_START_HASH = '# smelt:hooks v1 start';
 export const SNIPPET_END_HASH = '# smelt:hooks v1 end';
 /** Substring that identifies a file (or JSON hook entry) as written by this installer. */
 export const OURS_TOKEN = 'smelt:hooks';
+/**
+ * The version stamp, as the block's second line: which release wrote these bytes.
+ * The markers above stay byte-stable across releases — an upgrade must find the old
+ * block to replace it — so the version travels *inside* the block, where replacing
+ * the block replaces it. `smelt doctor` reads it back with {@link snippetStampVersion};
+ * a block without the line was written before stamping existed, and doctor says so
+ * instead of guessing a version nobody recorded.
+ */
+export const SNIPPET_STAMP_LINE = (version) => `<!-- smelt:hooks written-by @smeltjs/core ${version} -->`;
+/** The version a block was written by, or `undefined` when it predates stamping. */
+export function snippetStampVersion(text) {
+    return /<!-- smelt:hooks written-by @smeltjs\/core (\d+\.\d+\.\d+)(?:[-+][^>]*)? -->/u.exec(text)?.[1];
+}
 /**
  * The instruction snippet — belt and braces under every shim, and the *only* layer
  * for advisory harnesses. It teaches the three commands, and in particular what to do
  * after a guard deny: run the named replacement, then `smelt retrieve` per marker.
+ * `writtenBy` stamps the block for `smelt doctor`; omitted (legacy callers) the block
+ * simply carries no version line.
  */
-export function instructionSnippet(thresholdBytes, budgetBytes) {
+export function instructionSnippet(thresholdBytes, budgetBytes, writtenBy) {
+    const stamp = writtenBy === undefined ? '' : `${SNIPPET_STAMP_LINE(writtenBy)}\n`;
     return `${SNIPPET_START_MD}
-
+${stamp}
 ## smelt — context discipline
 
 This project uses [smelt](https://github.com/smeltjs/smelt) to keep large tool output

package/dist/harness/snippet.js.map

@@ -1 +1 @@
-{"version":3,"file":"snippet.js","sourceRoot":"","sources":["../../src/harness/snippet.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,oFAAoF;AACpF,MAAM,CAAC,MAAM,gBAAgB,GAAG,+BAA+B,CAAC;AAChE,MAAM,CAAC,MAAM,cAAc,GAAG,6BAA6B,CAAC;AAC5D,MAAM,CAAC,MAAM,kBAAkB,GAAG,wBAAwB,CAAC;AAC3D,MAAM,CAAC,MAAM,gBAAgB,GAAG,sBAAsB,CAAC;AAEvD,0FAA0F;AAC1F,MAAM,CAAC,MAAM,UAAU,GAAG,aAAa,CAAC;AAExC;;;;GAIG;AACH,MAAM,UAAU,kBAAkB,CAAC,cAAsB,EAAE,WAAmB;IAC5E,OAAO,GAAG,gBAAgB;;;;;;;2BAOD,MAAM,CAAC,cAAc,CAAC;4BACrB,MAAM,CAAC,WAAW,CAAC;;;;;;4CAMH,MAAM,CAAC,WAAW,CAAC;;;;;EAK7D,cAAc;CACf,CAAC;AACF,CAAC","sourcesContent":["/**\n * The text every harness shares: the marker lines that bracket a block this installer\n * owns inside somebody else's file, the token that identifies a hook entry as ours,\n * and the instruction snippet itself.\n */\n\n/** Marker lines bracketing every block this installer owns inside a shared file. */\nexport const SNIPPET_START_MD = '<!-- smelt:hooks v1 start -->';\nexport const SNIPPET_END_MD = '<!-- smelt:hooks v1 end -->';\nexport const SNIPPET_START_HASH = '# smelt:hooks v1 start';\nexport const SNIPPET_END_HASH = '# smelt:hooks v1 end';\n\n/** Substring that identifies a file (or JSON hook entry) as written by this installer. */\nexport const OURS_TOKEN = 'smelt:hooks';\n\n/**\n * The instruction snippet — belt and braces under every shim, and the *only* layer\n * for advisory harnesses. It teaches the three commands, and in particular what to do\n * after a guard deny: run the named replacement, then `smelt retrieve` per marker.\n */\nexport function instructionSnippet(thresholdBytes: number, budgetBytes: number): string {\n  return `${SNIPPET_START_MD}\n\n## smelt — context discipline\n\nThis project uses [smelt](https://github.com/smeltjs/smelt) to keep large tool output\nout of the context window, reversibly.\n\n- Do not read files over ${String(thresholdBytes)} bytes raw. Run\n  \\`smelt <file> --budget ${String(budgetBytes)} --focus <what you are looking for>\\`\n  instead (repeat \\`--focus\\` per term). Focused regions survive verbatim; everything\n  else collapses into a one-line marker stating what was removed.\n- Every marker ends in \\`retrieve(\"hash\")\\`. \\`smelt retrieve <hash>\\` prints the\n  exact original bytes back. Retrieve what you actually need — retrievals are counted,\n  and \\`smelt stats\\` reports the honest expansion rate.\n- For orientation, \\`smelt map . --budget ${String(budgetBytes)}\\` prints a ranked\n  symbol map of the repository.\n- If a smelt guard hook denies a raw read, run the exact replacement command named in\n  the denial, then \\`smelt retrieve\\` any marker you need expanded.\n\n${SNIPPET_END_MD}\n`;\n}\n"]}
+{"version":3,"file":"snippet.js","sourceRoot":"","sources":["../../src/harness/snippet.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,oFAAoF;AACpF,MAAM,CAAC,MAAM,gBAAgB,GAAG,+BAA+B,CAAC;AAChE,MAAM,CAAC,MAAM,cAAc,GAAG,6BAA6B,CAAC;AAC5D,MAAM,CAAC,MAAM,kBAAkB,GAAG,wBAAwB,CAAC;AAC3D,MAAM,CAAC,MAAM,gBAAgB,GAAG,sBAAsB,CAAC;AAEvD,0FAA0F;AAC1F,MAAM,CAAC,MAAM,UAAU,GAAG,aAAa,CAAC;AAExC;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,OAAe,EAAU,EAAE,CAC5D,6CAA6C,OAAO,MAAM,CAAC;AAE7D,oFAAoF;AACpF,MAAM,UAAU,mBAAmB,CAAC,IAAY;IAC9C,OAAO,+EAA+E,CAAC,IAAI,CACzF,IAAI,CACL,EAAE,CAAC,CAAC,CAAC,CAAC;AACT,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,kBAAkB,CAChC,cAAsB,EACtB,WAAmB,EACnB,SAAkB;IAElB,MAAM,KAAK,GAAG,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,kBAAkB,CAAC,SAAS,CAAC,IAAI,CAAC;IAClF,OAAO,GAAG,gBAAgB;EAC1B,KAAK;;;;;;2BAMoB,MAAM,CAAC,cAAc,CAAC;4BACrB,MAAM,CAAC,WAAW,CAAC;;;;;;4CAMH,MAAM,CAAC,WAAW,CAAC;;;;;EAK7D,cAAc;CACf,CAAC;AACF,CAAC","sourcesContent":["/**\n * The text every harness shares: the marker lines that bracket a block this installer\n * owns inside somebody else's file, the token that identifies a hook entry as ours,\n * and the instruction snippet itself.\n */\n\n/** Marker lines bracketing every block this installer owns inside a shared file. */\nexport const SNIPPET_START_MD = '<!-- smelt:hooks v1 start -->';\nexport const SNIPPET_END_MD = '<!-- smelt:hooks v1 end -->';\nexport const SNIPPET_START_HASH = '# smelt:hooks v1 start';\nexport const SNIPPET_END_HASH = '# smelt:hooks v1 end';\n\n/** Substring that identifies a file (or JSON hook entry) as written by this installer. */\nexport const OURS_TOKEN = 'smelt:hooks';\n\n/**\n * The version stamp, as the block's second line: which release wrote these bytes.\n * The markers above stay byte-stable across releases — an upgrade must find the old\n * block to replace it — so the version travels *inside* the block, where replacing\n * the block replaces it. `smelt doctor` reads it back with {@link snippetStampVersion};\n * a block without the line was written before stamping existed, and doctor says so\n * instead of guessing a version nobody recorded.\n */\nexport const SNIPPET_STAMP_LINE = (version: string): string =>\n  `<!-- smelt:hooks written-by @smeltjs/core ${version} -->`;\n\n/** The version a block was written by, or `undefined` when it predates stamping. */\nexport function snippetStampVersion(text: string): string | undefined {\n  return /<!-- smelt:hooks written-by @smeltjs\\/core (\\d+\\.\\d+\\.\\d+)(?:[-+][^>]*)? -->/u.exec(\n    text,\n  )?.[1];\n}\n\n/**\n * The instruction snippet — belt and braces under every shim, and the *only* layer\n * for advisory harnesses. It teaches the three commands, and in particular what to do\n * after a guard deny: run the named replacement, then `smelt retrieve` per marker.\n * `writtenBy` stamps the block for `smelt doctor`; omitted (legacy callers) the block\n * simply carries no version line.\n */\nexport function instructionSnippet(\n  thresholdBytes: number,\n  budgetBytes: number,\n  writtenBy?: string,\n): string {\n  const stamp = writtenBy === undefined ? '' : `${SNIPPET_STAMP_LINE(writtenBy)}\\n`;\n  return `${SNIPPET_START_MD}\n${stamp}\n## smelt — context discipline\n\nThis project uses [smelt](https://github.com/smeltjs/smelt) to keep large tool output\nout of the context window, reversibly.\n\n- Do not read files over ${String(thresholdBytes)} bytes raw. Run\n  \\`smelt <file> --budget ${String(budgetBytes)} --focus <what you are looking for>\\`\n  instead (repeat \\`--focus\\` per term). Focused regions survive verbatim; everything\n  else collapses into a one-line marker stating what was removed.\n- Every marker ends in \\`retrieve(\"hash\")\\`. \\`smelt retrieve <hash>\\` prints the\n  exact original bytes back. Retrieve what you actually need — retrievals are counted,\n  and \\`smelt stats\\` reports the honest expansion rate.\n- For orientation, \\`smelt map . --budget ${String(budgetBytes)}\\` prints a ranked\n  symbol map of the repository.\n- If a smelt guard hook denies a raw read, run the exact replacement command named in\n  the denial, then \\`smelt retrieve\\` any marker you need expanded.\n\n${SNIPPET_END_MD}\n`;\n}\n"]}

package/dist/index.d.ts

@@ -48,10 +48,32 @@ export { CONFIG_FILE_NAME, CONFIG_VERSION, configuredStore, findConfigFile, load
 export type { ConfiguredStore, LoadedConfig, SmeltConfig, SmeltConfigStore } from './cli/config.ts';
 export { MEASURE_STUB_FILE, measureStubSource, RERANK_STUB_FILE, rerankStubSource, runInit, } from './cli/init.ts';
 export type { InitIo } from './cli/init.ts';
+export { runSetup } from './cli/setup.ts';
+export type { SetupCheck, SetupFileAction, SetupIo, SetupOptions, SetupReceipt, } from './cli/setup.ts';
+export { runDoctor } from './cli/doctor.ts';
+export type { DoctorBlock, DoctorConfig, DoctorIo, DoctorMcp, DoctorOptions, DoctorReceipt, } from './cli/doctor.ts';
 export { retrieveStats } from './stats.ts';
 export type { RawRetrieveCounters } from './stats.ts';
+/**
+ * The SetupRecipe: the one true way to put smelt on a machine, as data. Public for the
+ * same reason the harness views are — something outside this package renders it (the
+ * site's fact generator), and the docs and skill are pinned to it rather than retyping
+ * it. See `src/setup/recipe.ts`.
+ */
+export { SETUP_RECIPE, SETUP_STEPS } from './setup/recipe.ts';
+export type { SetupRecipe, SetupStep } from './setup/recipe.ts';
 export { LANGUAGE_PROFILES, profileFor, profileForPath, structuralLanguages, } from './lang/registry.ts';
 export type { LanguageProfile, LanguageStructure, RepoMapFacts } from './lang/profile.ts';
+/**
+ * The harness registry's rendered views. Public for the same reason the ops seam is:
+ * something outside this package renders them — the site's `facts.json` generator —
+ * and the alternative is a second copy of the tier table typed into a React component,
+ * which is exactly the drift `harnessesByTier()` exists to end.
+ */
+export { harnessesByTier, harnessNames, HARNESSES, HARNESS_IDS } from './harness/registry.ts';
+export type { HarnessTierGroup } from './harness/registry.ts';
+export { harnessLabel, HARNESS_TIERS, TIER_HONESTY } from './harness/profile.ts';
+export type { HarnessId, HarnessTier } from './harness/profile.ts';
 export { resolveRun } from './cli/subcommands/smelt.ts';
 export type { ResolvedRun } from './cli/subcommands/smelt.ts';
 export { REPO_MAP_FOCUS_RULE } from './repomap/map.ts';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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","sourcesContent":["import type { ApplyOptions, MarkerBuilder, MarkerInfo } from './apply.ts';\n\n/**\n * The public surface: a barrel over the modules that hold the reasoning.\n *\n * `createSmelter()` itself lives in `./smelter.ts` so that nothing inside `src/` has\n * to import this file to build a smelter — the CLI's default verb does exactly that,\n * and a barrel that imports the CLI which imports the barrel is a cycle whose only\n * symptom is a registry evaluating to `undefined` in whichever module the loader\n * entered first. Every name is re-exported here, so consumers see no difference.\n */\n\nexport type { ApplyOptions, MarkerBuilder, MarkerInfo };\nexport {\n  applyPlan,\n  defaultMarker,\n  MARKER_FORMAT_VERSION,\n  markerPricing,\n  reconstruct,\n} from './apply.ts';\nexport { detectLanguage, SUPPORTED_LANGUAGES } from './detect.ts';\nexport * from './errors.ts';\nexport { contentHash, HASH_LENGTH } from './hash.ts';\nexport {\n  ALLOWED_NODE_BUILTINS,\n  ALLOWED_PACKAGES,\n  ALLOWED_URL_SCHEMES,\n  assertLocalResource,\n  FORBIDDEN_GLOBALS,\n  FORBIDDEN_NODE_MODULES,\n  FORBIDDEN_PACKAGES,\n} from './net/policy.ts';\nexport type { LocalResource } from './net/policy.ts';\nexport { clearGrammarCache, grammarPath, loadGrammar, WASM_BY_LANGUAGE } from './plan/grammar.ts';\nexport { AUTO_PLANNER_ID, AutoPlanner, planAuto } from './plan/auto.ts';\nexport type { AutoPlannerOptions } from './plan/auto.ts';\nexport { LEXICAL_PLANNER_ID, LexicalPlanner, planLexical } from './plan/lexical.ts';\nexport type { LexicalPlannerOptions } from './plan/lexical.ts';\nexport { DEFAULT_STRATEGY, isStrategy, PLANNERS, STRATEGIES } from './plan/planners.ts';\nexport type { PlannerFactoryOptions } from './plan/planners.ts';\nexport {\n  isStructuralLanguage,\n  planStructural,\n  STRUCTURAL_LANGUAGES,\n  STRUCTURAL_PLANNER_ID,\n  StructuralPlanner,\n} from './plan/structural.ts';\nexport type { StructuralLanguage, StructuralPlannerOptions } from './plan/structural.ts';\nexport { createRetrieveTool, RETRIEVE_TOOL_NAME } from './retrieve.ts';\nexport { unconfiguredDistillStage, unconfiguredRerankStage } from './stages.ts';\nexport { MemoryElisionStore } from './store.ts';\nexport {\n  DIRECTORY_STORE_FORMAT,\n  DIRECTORY_STORE_VERSION,\n  DirectoryElisionStore,\n} from './store-dir.ts';\nexport type { DirectoryElisionStoreOptions } from './store-dir.ts';\nexport * from './types.ts';\nexport {\n  CLI_JSON_FORMAT,\n  CLI_NAME,\n  cliUsage,\n  EXIT,\n  formatReport,\n  parseSmeltArgs,\n  runCli,\n} from './cli/run.ts';\nexport type { AnswerStream, CliIo, CliJsonEnvelope, SmeltInvocation } from './cli/run.ts';\nexport {\n  ANTHROPIC_PROMPT_CACHE_FACTS,\n  CACHE_BREAKER_RULES,\n  detectCacheBreakers,\n  findPrefixDivergence,\n} from './cache/prefix.ts';\nexport type {\n  CacheWarning,\n  PrefixDivergence,\n  PromptStructure,\n  PromptTool,\n} from './cache/prefix.ts';\nexport { MARKER_LINE_COMMENT_LEADERS, markerForLanguage } from './apply.ts';\nexport {\n  buildRepoMap,\n  DEFAULT_REPO_IGNORE,\n  REPO_MAP_CACHE_CORRUPT_RULE,\n  REPO_MAP_ID,\n  REPO_MAP_PATH_ONLY_RULE,\n  REPO_MAP_RANKED_RULE,\n  REPO_MAP_UNREFERENCED_RULE,\n} from './repomap/map.ts';\nexport type {\n  RepoMap,\n  RepoMapCacheCounts,\n  RepoMapEntry,\n  RepoMapOptions,\n  RepoMapPathEntry,\n  RepoMapReason,\n  RepoMapWarning,\n} from './repomap/map.ts';\nexport { PAGERANK_DAMPING, PAGERANK_ITERATIONS, rankDefinitions } from './repomap/rank.ts';\nexport type { FileTagsEntry, RankedDefinition } from './repomap/rank.ts';\nexport { extractTags } from './repomap/tags.ts';\nexport type { DefinitionTag, FileTags, ReferenceTag } from './repomap/tags.ts';\nexport { TAGS_CACHE_FORMAT, TAGS_CACHE_VERSION, tagsCacheKey } from './repomap/cache.ts';\nexport { nodeFsReader } from './repomap/reader.ts';\nexport type { DirEntry, FileStat, RepoReader } from './repomap/reader.ts';\nexport {\n  CONFIG_FILE_NAME,\n  CONFIG_VERSION,\n  configuredStore,\n  findConfigFile,\n  loadNearestConfig,\n  parseConfig,\n  renderConfig,\n  resolveStorePath,\n} from './cli/config.ts';\nexport type { ConfiguredStore, LoadedConfig, SmeltConfig, SmeltConfigStore } from './cli/config.ts';\nexport {\n  MEASURE_STUB_FILE,\n  measureStubSource,\n  RERANK_STUB_FILE,\n  rerankStubSource,\n  runInit,\n} from './cli/init.ts';\nexport type { InitIo } from './cli/init.ts';\nexport { retrieveStats } from './stats.ts';\nexport type { RawRetrieveCounters } from './stats.ts';\nexport {\n  LANGUAGE_PROFILES,\n  profileFor,\n  profileForPath,\n  structuralLanguages,\n} from './lang/registry.ts';\nexport type { LanguageProfile, LanguageStructure, RepoMapFacts } from './lang/profile.ts';\nexport { resolveRun } from './cli/subcommands/smelt.ts';\nexport type { ResolvedRun } from './cli/subcommands/smelt.ts';\nexport { REPO_MAP_FOCUS_RULE } from './repomap/map.ts';\nexport { CLI_MAP_JSON_FORMAT, formatMapReport, resolveMapRun } from './cli/run.ts';\nexport type { CliInvocation, CliMapJsonEnvelope, MapInvocation } from './cli/run.ts';\nexport type { MapReportInput } from './cli/report.ts';\nexport type { ResolvedMapRun } from './cli/subcommands/map.ts';\n\n/**\n * The operations seam — the four verbs and the laws their inputs must satisfy, below\n * every front door. `@smeltjs/mcp` consumes these as an ordinary dependency, so the\n * `smelt` CLI and the MCP tools run the same middle instead of two copies of it. See\n * `src/ops/index.ts` for what belongs here and what stays in an adapter.\n */\nexport {\n  budgetFault,\n  budgetMalformed,\n  budgetRequired,\n  mapTree,\n  openStore,\n  readBlob,\n  readCounters,\n  readTree,\n  resolveStrategy,\n  retrieveBytes,\n  smeltBlob,\n} from './ops/index.ts';\nexport type {\n  BudgetFault,\n  BudgetNaming,\n  MapTreeOp,\n  ReadCountersOp,\n  ResolvedStrategy,\n  RetrieveBytesOp,\n  Ruling,\n  SmeltBlobOp,\n  SmeltBlobOutcome,\n  StrategySource,\n  TreeNaming,\n} from './ops/index.ts';\n\n/**\n * Which planner a smelter uses, named by string. The names, their factories, and this\n * type all come from the one {@link PLANNERS} registry in `src/plan/planners.ts`, so\n * the CLI's validation and help text cannot drift from what `createSmelter` builds.\n */\nexport type { Strategy } from './plan/planners.ts';\n\nexport { createSmelter } from './smelter.ts';\nexport type { Smelter, SmelterConfig, SmeltCallOptions } from './smelter.ts';\n"]}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE1E;;;;;;;;GAQG;AAEH,YAAY,EAAE,YAAY,EAAE,aAAa,EAAE,UAAU,EAAE,CAAC;AACxD,OAAO,EACL,SAAS,EACT,aAAa,EACb,qBAAqB,EACrB,aAAa,EACb,WAAW,GACZ,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAClE,cAAc,aAAa,CAAC;AAC5B,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACrD,OAAO,EACL,qBAAqB,EACrB,gBAAgB,EAChB,mBAAmB,EACnB,mBAAmB,EACnB,iBAAiB,EACjB,sBAAsB,EACtB,kBAAkB,GACnB,MAAM,iBAAiB,CAAC;AACzB,YAAY,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AACrD,OAAO,EAAE,iBAAiB,EAAE,WAAW,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAClG,OAAO,EAAE,eAAe,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AACxE,YAAY,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AACzD,OAAO,EAAE,kBAAkB,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACpF,YAAY,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAC/D,OAAO,EAAE,gBAAgB,EAAE,UAAU,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AACxF,YAAY,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAChE,OAAO,EACL,oBAAoB,EACpB,cAAc,EACd,oBAAoB,EACpB,qBAAqB,EACrB,iBAAiB,GAClB,MAAM,sBAAsB,CAAC;AAC9B,YAAY,EAAE,kBAAkB,EAAE,wBAAwB,EAAE,MAAM,sBAAsB,CAAC;AACzF,OAAO,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AACvE,OAAO,EAAE,wBAAwB,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAC;AAChF,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAChD,OAAO,EACL,sBAAsB,EACtB,uBAAuB,EACvB,qBAAqB,GACtB,MAAM,gBAAgB,CAAC;AACxB,YAAY,EAAE,4BAA4B,EAAE,MAAM,gBAAgB,CAAC;AACnE,cAAc,YAAY,CAAC;AAC3B,OAAO,EACL,eAAe,EACf,QAAQ,EACR,QAAQ,EACR,IAAI,EACJ,YAAY,EACZ,cAAc,EACd,MAAM,GACP,MAAM,cAAc,CAAC;AACtB,YAAY,EAAE,YAAY,EAAE,KAAK,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC1F,OAAO,EACL,4BAA4B,EAC5B,mBAAmB,EACnB,mBAAmB,EACnB,oBAAoB,GACrB,MAAM,mBAAmB,CAAC;AAC3B,YAAY,EACV,YAAY,EACZ,gBAAgB,EAChB,eAAe,EACf,UAAU,GACX,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,2BAA2B,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAC5E,OAAO,EACL,YAAY,EACZ,mBAAmB,EACnB,2BAA2B,EAC3B,WAAW,EACX,uBAAuB,EACvB,oBAAoB,EACpB,0BAA0B,GAC3B,MAAM,kBAAkB,CAAC;AAC1B,YAAY,EACV,OAAO,EACP,kBAAkB,EAClB,YAAY,EACZ,cAAc,EACd,gBAAgB,EAChB,aAAa,EACb,cAAc,GACf,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAC3F,YAAY,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AACzE,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,YAAY,EAAE,aAAa,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAC/E,OAAO,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACzF,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,YAAY,EAAE,QAAQ,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAC1E,OAAO,EACL,gBAAgB,EAChB,cAAc,EACd,eAAe,EACf,cAAc,EACd,iBAAiB,EACjB,WAAW,EACX,YAAY,EACZ,gBAAgB,GACjB,MAAM,iBAAiB,CAAC;AACzB,YAAY,EAAE,eAAe,EAAE,YAAY,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACpG,OAAO,EACL,iBAAiB,EACjB,iBAAiB,EACjB,gBAAgB,EAChB,gBAAgB,EAChB,OAAO,GACR,MAAM,eAAe,CAAC;AACvB,YAAY,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,YAAY,EACV,UAAU,EACV,eAAe,EACf,OAAO,EACP,YAAY,EACZ,YAAY,GACb,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,YAAY,EACV,WAAW,EACX,YAAY,EACZ,QAAQ,EACR,SAAS,EACT,aAAa,EACb,aAAa,GACd,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAC3C,YAAY,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAEtD;;;;;GAKG;AACH,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAC9D,YAAY,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAChE,OAAO,EACL,iBAAiB,EACjB,UAAU,EACV,cAAc,EACd,mBAAmB,GACpB,MAAM,oBAAoB,CAAC;AAC5B,YAAY,EAAE,eAAe,EAAE,iBAAiB,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAC1F;;;;;GAKG;AACH,OAAO,EAAE,eAAe,EAAE,YAAY,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAC9F,YAAY,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAC9D,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACjF,YAAY,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACnE,OAAO,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AACxD,YAAY,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAC9D,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,EAAE,mBAAmB,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AACnF,YAAY,EAAE,aAAa,EAAE,kBAAkB,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AACrF,YAAY,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACtD,YAAY,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAE/D;;;;;GAKG;AACH,OAAO,EACL,WAAW,EACX,eAAe,EACf,cAAc,EACd,OAAO,EACP,SAAS,EACT,QAAQ,EACR,YAAY,EACZ,QAAQ,EACR,eAAe,EACf,aAAa,EACb,SAAS,GACV,MAAM,gBAAgB,CAAC;AACxB,YAAY,EACV,WAAW,EACX,YAAY,EACZ,SAAS,EACT,cAAc,EACd,gBAAgB,EAChB,eAAe,EACf,MAAM,EACN,WAAW,EACX,gBAAgB,EAChB,cAAc,EACd,UAAU,GACX,MAAM,gBAAgB,CAAC;AAExB;;;;GAIG;AACH,YAAY,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAEnD,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC7C,YAAY,EAAE,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC","sourcesContent":["import type { ApplyOptions, MarkerBuilder, MarkerInfo } from './apply.ts';\n\n/**\n * The public surface: a barrel over the modules that hold the reasoning.\n *\n * `createSmelter()` itself lives in `./smelter.ts` so that nothing inside `src/` has\n * to import this file to build a smelter — the CLI's default verb does exactly that,\n * and a barrel that imports the CLI which imports the barrel is a cycle whose only\n * symptom is a registry evaluating to `undefined` in whichever module the loader\n * entered first. Every name is re-exported here, so consumers see no difference.\n */\n\nexport type { ApplyOptions, MarkerBuilder, MarkerInfo };\nexport {\n  applyPlan,\n  defaultMarker,\n  MARKER_FORMAT_VERSION,\n  markerPricing,\n  reconstruct,\n} from './apply.ts';\nexport { detectLanguage, SUPPORTED_LANGUAGES } from './detect.ts';\nexport * from './errors.ts';\nexport { contentHash, HASH_LENGTH } from './hash.ts';\nexport {\n  ALLOWED_NODE_BUILTINS,\n  ALLOWED_PACKAGES,\n  ALLOWED_URL_SCHEMES,\n  assertLocalResource,\n  FORBIDDEN_GLOBALS,\n  FORBIDDEN_NODE_MODULES,\n  FORBIDDEN_PACKAGES,\n} from './net/policy.ts';\nexport type { LocalResource } from './net/policy.ts';\nexport { clearGrammarCache, grammarPath, loadGrammar, WASM_BY_LANGUAGE } from './plan/grammar.ts';\nexport { AUTO_PLANNER_ID, AutoPlanner, planAuto } from './plan/auto.ts';\nexport type { AutoPlannerOptions } from './plan/auto.ts';\nexport { LEXICAL_PLANNER_ID, LexicalPlanner, planLexical } from './plan/lexical.ts';\nexport type { LexicalPlannerOptions } from './plan/lexical.ts';\nexport { DEFAULT_STRATEGY, isStrategy, PLANNERS, STRATEGIES } from './plan/planners.ts';\nexport type { PlannerFactoryOptions } from './plan/planners.ts';\nexport {\n  isStructuralLanguage,\n  planStructural,\n  STRUCTURAL_LANGUAGES,\n  STRUCTURAL_PLANNER_ID,\n  StructuralPlanner,\n} from './plan/structural.ts';\nexport type { StructuralLanguage, StructuralPlannerOptions } from './plan/structural.ts';\nexport { createRetrieveTool, RETRIEVE_TOOL_NAME } from './retrieve.ts';\nexport { unconfiguredDistillStage, unconfiguredRerankStage } from './stages.ts';\nexport { MemoryElisionStore } from './store.ts';\nexport {\n  DIRECTORY_STORE_FORMAT,\n  DIRECTORY_STORE_VERSION,\n  DirectoryElisionStore,\n} from './store-dir.ts';\nexport type { DirectoryElisionStoreOptions } from './store-dir.ts';\nexport * from './types.ts';\nexport {\n  CLI_JSON_FORMAT,\n  CLI_NAME,\n  cliUsage,\n  EXIT,\n  formatReport,\n  parseSmeltArgs,\n  runCli,\n} from './cli/run.ts';\nexport type { AnswerStream, CliIo, CliJsonEnvelope, SmeltInvocation } from './cli/run.ts';\nexport {\n  ANTHROPIC_PROMPT_CACHE_FACTS,\n  CACHE_BREAKER_RULES,\n  detectCacheBreakers,\n  findPrefixDivergence,\n} from './cache/prefix.ts';\nexport type {\n  CacheWarning,\n  PrefixDivergence,\n  PromptStructure,\n  PromptTool,\n} from './cache/prefix.ts';\nexport { MARKER_LINE_COMMENT_LEADERS, markerForLanguage } from './apply.ts';\nexport {\n  buildRepoMap,\n  DEFAULT_REPO_IGNORE,\n  REPO_MAP_CACHE_CORRUPT_RULE,\n  REPO_MAP_ID,\n  REPO_MAP_PATH_ONLY_RULE,\n  REPO_MAP_RANKED_RULE,\n  REPO_MAP_UNREFERENCED_RULE,\n} from './repomap/map.ts';\nexport type {\n  RepoMap,\n  RepoMapCacheCounts,\n  RepoMapEntry,\n  RepoMapOptions,\n  RepoMapPathEntry,\n  RepoMapReason,\n  RepoMapWarning,\n} from './repomap/map.ts';\nexport { PAGERANK_DAMPING, PAGERANK_ITERATIONS, rankDefinitions } from './repomap/rank.ts';\nexport type { FileTagsEntry, RankedDefinition } from './repomap/rank.ts';\nexport { extractTags } from './repomap/tags.ts';\nexport type { DefinitionTag, FileTags, ReferenceTag } from './repomap/tags.ts';\nexport { TAGS_CACHE_FORMAT, TAGS_CACHE_VERSION, tagsCacheKey } from './repomap/cache.ts';\nexport { nodeFsReader } from './repomap/reader.ts';\nexport type { DirEntry, FileStat, RepoReader } from './repomap/reader.ts';\nexport {\n  CONFIG_FILE_NAME,\n  CONFIG_VERSION,\n  configuredStore,\n  findConfigFile,\n  loadNearestConfig,\n  parseConfig,\n  renderConfig,\n  resolveStorePath,\n} from './cli/config.ts';\nexport type { ConfiguredStore, LoadedConfig, SmeltConfig, SmeltConfigStore } from './cli/config.ts';\nexport {\n  MEASURE_STUB_FILE,\n  measureStubSource,\n  RERANK_STUB_FILE,\n  rerankStubSource,\n  runInit,\n} from './cli/init.ts';\nexport type { InitIo } from './cli/init.ts';\nexport { runSetup } from './cli/setup.ts';\nexport type {\n  SetupCheck,\n  SetupFileAction,\n  SetupIo,\n  SetupOptions,\n  SetupReceipt,\n} from './cli/setup.ts';\nexport { runDoctor } from './cli/doctor.ts';\nexport type {\n  DoctorBlock,\n  DoctorConfig,\n  DoctorIo,\n  DoctorMcp,\n  DoctorOptions,\n  DoctorReceipt,\n} from './cli/doctor.ts';\nexport { retrieveStats } from './stats.ts';\nexport type { RawRetrieveCounters } from './stats.ts';\n\n/**\n * The SetupRecipe: the one true way to put smelt on a machine, as data. Public for the\n * same reason the harness views are — something outside this package renders it (the\n * site's fact generator), and the docs and skill are pinned to it rather than retyping\n * it. See `src/setup/recipe.ts`.\n */\nexport { SETUP_RECIPE, SETUP_STEPS } from './setup/recipe.ts';\nexport type { SetupRecipe, SetupStep } from './setup/recipe.ts';\nexport {\n  LANGUAGE_PROFILES,\n  profileFor,\n  profileForPath,\n  structuralLanguages,\n} from './lang/registry.ts';\nexport type { LanguageProfile, LanguageStructure, RepoMapFacts } from './lang/profile.ts';\n/**\n * The harness registry's rendered views. Public for the same reason the ops seam is:\n * something outside this package renders them — the site's `facts.json` generator —\n * and the alternative is a second copy of the tier table typed into a React component,\n * which is exactly the drift `harnessesByTier()` exists to end.\n */\nexport { harnessesByTier, harnessNames, HARNESSES, HARNESS_IDS } from './harness/registry.ts';\nexport type { HarnessTierGroup } from './harness/registry.ts';\nexport { harnessLabel, HARNESS_TIERS, TIER_HONESTY } from './harness/profile.ts';\nexport type { HarnessId, HarnessTier } from './harness/profile.ts';\nexport { resolveRun } from './cli/subcommands/smelt.ts';\nexport type { ResolvedRun } from './cli/subcommands/smelt.ts';\nexport { REPO_MAP_FOCUS_RULE } from './repomap/map.ts';\nexport { CLI_MAP_JSON_FORMAT, formatMapReport, resolveMapRun } from './cli/run.ts';\nexport type { CliInvocation, CliMapJsonEnvelope, MapInvocation } from './cli/run.ts';\nexport type { MapReportInput } from './cli/report.ts';\nexport type { ResolvedMapRun } from './cli/subcommands/map.ts';\n\n/**\n * The operations seam — the four verbs and the laws their inputs must satisfy, below\n * every front door. `@smeltjs/mcp` consumes these as an ordinary dependency, so the\n * `smelt` CLI and the MCP tools run the same middle instead of two copies of it. See\n * `src/ops/index.ts` for what belongs here and what stays in an adapter.\n */\nexport {\n  budgetFault,\n  budgetMalformed,\n  budgetRequired,\n  mapTree,\n  openStore,\n  readBlob,\n  readCounters,\n  readTree,\n  resolveStrategy,\n  retrieveBytes,\n  smeltBlob,\n} from './ops/index.ts';\nexport type {\n  BudgetFault,\n  BudgetNaming,\n  MapTreeOp,\n  ReadCountersOp,\n  ResolvedStrategy,\n  RetrieveBytesOp,\n  Ruling,\n  SmeltBlobOp,\n  SmeltBlobOutcome,\n  StrategySource,\n  TreeNaming,\n} from './ops/index.ts';\n\n/**\n * Which planner a smelter uses, named by string. The names, their factories, and this\n * type all come from the one {@link PLANNERS} registry in `src/plan/planners.ts`, so\n * the CLI's validation and help text cannot drift from what `createSmelter` builds.\n */\nexport type { Strategy } from './plan/planners.ts';\n\nexport { createSmelter } from './smelter.ts';\nexport type { Smelter, SmelterConfig, SmeltCallOptions } from './smelter.ts';\n"]}

package/dist/index.js

@@ -23,8 +23,25 @@ export { TAGS_CACHE_FORMAT, TAGS_CACHE_VERSION, tagsCacheKey } from './repomap/c
 export { nodeFsReader } from './repomap/reader.js';
 export { CONFIG_FILE_NAME, CONFIG_VERSION, configuredStore, findConfigFile, loadNearestConfig, parseConfig, renderConfig, resolveStorePath, } from './cli/config.js';
 export { MEASURE_STUB_FILE, measureStubSource, RERANK_STUB_FILE, rerankStubSource, runInit, } from './cli/init.js';
+export { runSetup } from './cli/setup.js';
+export { runDoctor } from './cli/doctor.js';
 export { retrieveStats } from './stats.js';
+/**
+ * The SetupRecipe: the one true way to put smelt on a machine, as data. Public for the
+ * same reason the harness views are — something outside this package renders it (the
+ * site's fact generator), and the docs and skill are pinned to it rather than retyping
+ * it. See `src/setup/recipe.ts`.
+ */
+export { SETUP_RECIPE, SETUP_STEPS } from './setup/recipe.js';
 export { LANGUAGE_PROFILES, profileFor, profileForPath, structuralLanguages, } from './lang/registry.js';
+/**
+ * The harness registry's rendered views. Public for the same reason the ops seam is:
+ * something outside this package renders them — the site's `facts.json` generator —
+ * and the alternative is a second copy of the tier table typed into a React component,
+ * which is exactly the drift `harnessesByTier()` exists to end.
+ */
+export { harnessesByTier, harnessNames, HARNESSES, HARNESS_IDS } from './harness/registry.js';
+export { harnessLabel, HARNESS_TIERS, TIER_HONESTY } from './harness/profile.js';
 export { resolveRun } from './cli/subcommands/smelt.js';
 export { REPO_MAP_FOCUS_RULE } from './repomap/map.js';
 export { CLI_MAP_JSON_FORMAT, formatMapReport, resolveMapRun } from './cli/run.js';

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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","sourcesContent":["import type { ApplyOptions, MarkerBuilder, MarkerInfo } from './apply.ts';\n\n/**\n * The public surface: a barrel over the modules that hold the reasoning.\n *\n * `createSmelter()` itself lives in `./smelter.ts` so that nothing inside `src/` has\n * to import this file to build a smelter — the CLI's default verb does exactly that,\n * and a barrel that imports the CLI which imports the barrel is a cycle whose only\n * symptom is a registry evaluating to `undefined` in whichever module the loader\n * entered first. Every name is re-exported here, so consumers see no difference.\n */\n\nexport type { ApplyOptions, MarkerBuilder, MarkerInfo };\nexport {\n  applyPlan,\n  defaultMarker,\n  MARKER_FORMAT_VERSION,\n  markerPricing,\n  reconstruct,\n} from './apply.ts';\nexport { detectLanguage, SUPPORTED_LANGUAGES } from './detect.ts';\nexport * from './errors.ts';\nexport { contentHash, HASH_LENGTH } from './hash.ts';\nexport {\n  ALLOWED_NODE_BUILTINS,\n  ALLOWED_PACKAGES,\n  ALLOWED_URL_SCHEMES,\n  assertLocalResource,\n  FORBIDDEN_GLOBALS,\n  FORBIDDEN_NODE_MODULES,\n  FORBIDDEN_PACKAGES,\n} from './net/policy.ts';\nexport type { LocalResource } from './net/policy.ts';\nexport { clearGrammarCache, grammarPath, loadGrammar, WASM_BY_LANGUAGE } from './plan/grammar.ts';\nexport { AUTO_PLANNER_ID, AutoPlanner, planAuto } from './plan/auto.ts';\nexport type { AutoPlannerOptions } from './plan/auto.ts';\nexport { LEXICAL_PLANNER_ID, LexicalPlanner, planLexical } from './plan/lexical.ts';\nexport type { LexicalPlannerOptions } from './plan/lexical.ts';\nexport { DEFAULT_STRATEGY, isStrategy, PLANNERS, STRATEGIES } from './plan/planners.ts';\nexport type { PlannerFactoryOptions } from './plan/planners.ts';\nexport {\n  isStructuralLanguage,\n  planStructural,\n  STRUCTURAL_LANGUAGES,\n  STRUCTURAL_PLANNER_ID,\n  StructuralPlanner,\n} from './plan/structural.ts';\nexport type { StructuralLanguage, StructuralPlannerOptions } from './plan/structural.ts';\nexport { createRetrieveTool, RETRIEVE_TOOL_NAME } from './retrieve.ts';\nexport { unconfiguredDistillStage, unconfiguredRerankStage } from './stages.ts';\nexport { MemoryElisionStore } from './store.ts';\nexport {\n  DIRECTORY_STORE_FORMAT,\n  DIRECTORY_STORE_VERSION,\n  DirectoryElisionStore,\n} from './store-dir.ts';\nexport type { DirectoryElisionStoreOptions } from './store-dir.ts';\nexport * from './types.ts';\nexport {\n  CLI_JSON_FORMAT,\n  CLI_NAME,\n  cliUsage,\n  EXIT,\n  formatReport,\n  parseSmeltArgs,\n  runCli,\n} from './cli/run.ts';\nexport type { AnswerStream, CliIo, CliJsonEnvelope, SmeltInvocation } from './cli/run.ts';\nexport {\n  ANTHROPIC_PROMPT_CACHE_FACTS,\n  CACHE_BREAKER_RULES,\n  detectCacheBreakers,\n  findPrefixDivergence,\n} from './cache/prefix.ts';\nexport type {\n  CacheWarning,\n  PrefixDivergence,\n  PromptStructure,\n  PromptTool,\n} from './cache/prefix.ts';\nexport { MARKER_LINE_COMMENT_LEADERS, markerForLanguage } from './apply.ts';\nexport {\n  buildRepoMap,\n  DEFAULT_REPO_IGNORE,\n  REPO_MAP_CACHE_CORRUPT_RULE,\n  REPO_MAP_ID,\n  REPO_MAP_PATH_ONLY_RULE,\n  REPO_MAP_RANKED_RULE,\n  REPO_MAP_UNREFERENCED_RULE,\n} from './repomap/map.ts';\nexport type {\n  RepoMap,\n  RepoMapCacheCounts,\n  RepoMapEntry,\n  RepoMapOptions,\n  RepoMapPathEntry,\n  RepoMapReason,\n  RepoMapWarning,\n} from './repomap/map.ts';\nexport { PAGERANK_DAMPING, PAGERANK_ITERATIONS, rankDefinitions } from './repomap/rank.ts';\nexport type { FileTagsEntry, RankedDefinition } from './repomap/rank.ts';\nexport { extractTags } from './repomap/tags.ts';\nexport type { DefinitionTag, FileTags, ReferenceTag } from './repomap/tags.ts';\nexport { TAGS_CACHE_FORMAT, TAGS_CACHE_VERSION, tagsCacheKey } from './repomap/cache.ts';\nexport { nodeFsReader } from './repomap/reader.ts';\nexport type { DirEntry, FileStat, RepoReader } from './repomap/reader.ts';\nexport {\n  CONFIG_FILE_NAME,\n  CONFIG_VERSION,\n  configuredStore,\n  findConfigFile,\n  loadNearestConfig,\n  parseConfig,\n  renderConfig,\n  resolveStorePath,\n} from './cli/config.ts';\nexport type { ConfiguredStore, LoadedConfig, SmeltConfig, SmeltConfigStore } from './cli/config.ts';\nexport {\n  MEASURE_STUB_FILE,\n  measureStubSource,\n  RERANK_STUB_FILE,\n  rerankStubSource,\n  runInit,\n} from './cli/init.ts';\nexport type { InitIo } from './cli/init.ts';\nexport { retrieveStats } from './stats.ts';\nexport type { RawRetrieveCounters } from './stats.ts';\nexport {\n  LANGUAGE_PROFILES,\n  profileFor,\n  profileForPath,\n  structuralLanguages,\n} from './lang/registry.ts';\nexport type { LanguageProfile, LanguageStructure, RepoMapFacts } from './lang/profile.ts';\nexport { resolveRun } from './cli/subcommands/smelt.ts';\nexport type { ResolvedRun } from './cli/subcommands/smelt.ts';\nexport { REPO_MAP_FOCUS_RULE } from './repomap/map.ts';\nexport { CLI_MAP_JSON_FORMAT, formatMapReport, resolveMapRun } from './cli/run.ts';\nexport type { CliInvocation, CliMapJsonEnvelope, MapInvocation } from './cli/run.ts';\nexport type { MapReportInput } from './cli/report.ts';\nexport type { ResolvedMapRun } from './cli/subcommands/map.ts';\n\n/**\n * The operations seam — the four verbs and the laws their inputs must satisfy, below\n * every front door. `@smeltjs/mcp` consumes these as an ordinary dependency, so the\n * `smelt` CLI and the MCP tools run the same middle instead of two copies of it. See\n * `src/ops/index.ts` for what belongs here and what stays in an adapter.\n */\nexport {\n  budgetFault,\n  budgetMalformed,\n  budgetRequired,\n  mapTree,\n  openStore,\n  readBlob,\n  readCounters,\n  readTree,\n  resolveStrategy,\n  retrieveBytes,\n  smeltBlob,\n} from './ops/index.ts';\nexport type {\n  BudgetFault,\n  BudgetNaming,\n  MapTreeOp,\n  ReadCountersOp,\n  ResolvedStrategy,\n  RetrieveBytesOp,\n  Ruling,\n  SmeltBlobOp,\n  SmeltBlobOutcome,\n  StrategySource,\n  TreeNaming,\n} from './ops/index.ts';\n\n/**\n * Which planner a smelter uses, named by string. The names, their factories, and this\n * type all come from the one {@link PLANNERS} registry in `src/plan/planners.ts`, so\n * the CLI's validation and help text cannot drift from what `createSmelter` builds.\n */\nexport type { Strategy } from './plan/planners.ts';\n\nexport { createSmelter } from './smelter.ts';\nexport type { Smelter, SmelterConfig, SmeltCallOptions } from './smelter.ts';\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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","sourcesContent":["import type { ApplyOptions, MarkerBuilder, MarkerInfo } from './apply.ts';\n\n/**\n * The public surface: a barrel over the modules that hold the reasoning.\n *\n * `createSmelter()` itself lives in `./smelter.ts` so that nothing inside `src/` has\n * to import this file to build a smelter — the CLI's default verb does exactly that,\n * and a barrel that imports the CLI which imports the barrel is a cycle whose only\n * symptom is a registry evaluating to `undefined` in whichever module the loader\n * entered first. Every name is re-exported here, so consumers see no difference.\n */\n\nexport type { ApplyOptions, MarkerBuilder, MarkerInfo };\nexport {\n  applyPlan,\n  defaultMarker,\n  MARKER_FORMAT_VERSION,\n  markerPricing,\n  reconstruct,\n} from './apply.ts';\nexport { detectLanguage, SUPPORTED_LANGUAGES } from './detect.ts';\nexport * from './errors.ts';\nexport { contentHash, HASH_LENGTH } from './hash.ts';\nexport {\n  ALLOWED_NODE_BUILTINS,\n  ALLOWED_PACKAGES,\n  ALLOWED_URL_SCHEMES,\n  assertLocalResource,\n  FORBIDDEN_GLOBALS,\n  FORBIDDEN_NODE_MODULES,\n  FORBIDDEN_PACKAGES,\n} from './net/policy.ts';\nexport type { LocalResource } from './net/policy.ts';\nexport { clearGrammarCache, grammarPath, loadGrammar, WASM_BY_LANGUAGE } from './plan/grammar.ts';\nexport { AUTO_PLANNER_ID, AutoPlanner, planAuto } from './plan/auto.ts';\nexport type { AutoPlannerOptions } from './plan/auto.ts';\nexport { LEXICAL_PLANNER_ID, LexicalPlanner, planLexical } from './plan/lexical.ts';\nexport type { LexicalPlannerOptions } from './plan/lexical.ts';\nexport { DEFAULT_STRATEGY, isStrategy, PLANNERS, STRATEGIES } from './plan/planners.ts';\nexport type { PlannerFactoryOptions } from './plan/planners.ts';\nexport {\n  isStructuralLanguage,\n  planStructural,\n  STRUCTURAL_LANGUAGES,\n  STRUCTURAL_PLANNER_ID,\n  StructuralPlanner,\n} from './plan/structural.ts';\nexport type { StructuralLanguage, StructuralPlannerOptions } from './plan/structural.ts';\nexport { createRetrieveTool, RETRIEVE_TOOL_NAME } from './retrieve.ts';\nexport { unconfiguredDistillStage, unconfiguredRerankStage } from './stages.ts';\nexport { MemoryElisionStore } from './store.ts';\nexport {\n  DIRECTORY_STORE_FORMAT,\n  DIRECTORY_STORE_VERSION,\n  DirectoryElisionStore,\n} from './store-dir.ts';\nexport type { DirectoryElisionStoreOptions } from './store-dir.ts';\nexport * from './types.ts';\nexport {\n  CLI_JSON_FORMAT,\n  CLI_NAME,\n  cliUsage,\n  EXIT,\n  formatReport,\n  parseSmeltArgs,\n  runCli,\n} from './cli/run.ts';\nexport type { AnswerStream, CliIo, CliJsonEnvelope, SmeltInvocation } from './cli/run.ts';\nexport {\n  ANTHROPIC_PROMPT_CACHE_FACTS,\n  CACHE_BREAKER_RULES,\n  detectCacheBreakers,\n  findPrefixDivergence,\n} from './cache/prefix.ts';\nexport type {\n  CacheWarning,\n  PrefixDivergence,\n  PromptStructure,\n  PromptTool,\n} from './cache/prefix.ts';\nexport { MARKER_LINE_COMMENT_LEADERS, markerForLanguage } from './apply.ts';\nexport {\n  buildRepoMap,\n  DEFAULT_REPO_IGNORE,\n  REPO_MAP_CACHE_CORRUPT_RULE,\n  REPO_MAP_ID,\n  REPO_MAP_PATH_ONLY_RULE,\n  REPO_MAP_RANKED_RULE,\n  REPO_MAP_UNREFERENCED_RULE,\n} from './repomap/map.ts';\nexport type {\n  RepoMap,\n  RepoMapCacheCounts,\n  RepoMapEntry,\n  RepoMapOptions,\n  RepoMapPathEntry,\n  RepoMapReason,\n  RepoMapWarning,\n} from './repomap/map.ts';\nexport { PAGERANK_DAMPING, PAGERANK_ITERATIONS, rankDefinitions } from './repomap/rank.ts';\nexport type { FileTagsEntry, RankedDefinition } from './repomap/rank.ts';\nexport { extractTags } from './repomap/tags.ts';\nexport type { DefinitionTag, FileTags, ReferenceTag } from './repomap/tags.ts';\nexport { TAGS_CACHE_FORMAT, TAGS_CACHE_VERSION, tagsCacheKey } from './repomap/cache.ts';\nexport { nodeFsReader } from './repomap/reader.ts';\nexport type { DirEntry, FileStat, RepoReader } from './repomap/reader.ts';\nexport {\n  CONFIG_FILE_NAME,\n  CONFIG_VERSION,\n  configuredStore,\n  findConfigFile,\n  loadNearestConfig,\n  parseConfig,\n  renderConfig,\n  resolveStorePath,\n} from './cli/config.ts';\nexport type { ConfiguredStore, LoadedConfig, SmeltConfig, SmeltConfigStore } from './cli/config.ts';\nexport {\n  MEASURE_STUB_FILE,\n  measureStubSource,\n  RERANK_STUB_FILE,\n  rerankStubSource,\n  runInit,\n} from './cli/init.ts';\nexport type { InitIo } from './cli/init.ts';\nexport { runSetup } from './cli/setup.ts';\nexport type {\n  SetupCheck,\n  SetupFileAction,\n  SetupIo,\n  SetupOptions,\n  SetupReceipt,\n} from './cli/setup.ts';\nexport { runDoctor } from './cli/doctor.ts';\nexport type {\n  DoctorBlock,\n  DoctorConfig,\n  DoctorIo,\n  DoctorMcp,\n  DoctorOptions,\n  DoctorReceipt,\n} from './cli/doctor.ts';\nexport { retrieveStats } from './stats.ts';\nexport type { RawRetrieveCounters } from './stats.ts';\n\n/**\n * The SetupRecipe: the one true way to put smelt on a machine, as data. Public for the\n * same reason the harness views are — something outside this package renders it (the\n * site's fact generator), and the docs and skill are pinned to it rather than retyping\n * it. See `src/setup/recipe.ts`.\n */\nexport { SETUP_RECIPE, SETUP_STEPS } from './setup/recipe.ts';\nexport type { SetupRecipe, SetupStep } from './setup/recipe.ts';\nexport {\n  LANGUAGE_PROFILES,\n  profileFor,\n  profileForPath,\n  structuralLanguages,\n} from './lang/registry.ts';\nexport type { LanguageProfile, LanguageStructure, RepoMapFacts } from './lang/profile.ts';\n/**\n * The harness registry's rendered views. Public for the same reason the ops seam is:\n * something outside this package renders them — the site's `facts.json` generator —\n * and the alternative is a second copy of the tier table typed into a React component,\n * which is exactly the drift `harnessesByTier()` exists to end.\n */\nexport { harnessesByTier, harnessNames, HARNESSES, HARNESS_IDS } from './harness/registry.ts';\nexport type { HarnessTierGroup } from './harness/registry.ts';\nexport { harnessLabel, HARNESS_TIERS, TIER_HONESTY } from './harness/profile.ts';\nexport type { HarnessId, HarnessTier } from './harness/profile.ts';\nexport { resolveRun } from './cli/subcommands/smelt.ts';\nexport type { ResolvedRun } from './cli/subcommands/smelt.ts';\nexport { REPO_MAP_FOCUS_RULE } from './repomap/map.ts';\nexport { CLI_MAP_JSON_FORMAT, formatMapReport, resolveMapRun } from './cli/run.ts';\nexport type { CliInvocation, CliMapJsonEnvelope, MapInvocation } from './cli/run.ts';\nexport type { MapReportInput } from './cli/report.ts';\nexport type { ResolvedMapRun } from './cli/subcommands/map.ts';\n\n/**\n * The operations seam — the four verbs and the laws their inputs must satisfy, below\n * every front door. `@smeltjs/mcp` consumes these as an ordinary dependency, so the\n * `smelt` CLI and the MCP tools run the same middle instead of two copies of it. See\n * `src/ops/index.ts` for what belongs here and what stays in an adapter.\n */\nexport {\n  budgetFault,\n  budgetMalformed,\n  budgetRequired,\n  mapTree,\n  openStore,\n  readBlob,\n  readCounters,\n  readTree,\n  resolveStrategy,\n  retrieveBytes,\n  smeltBlob,\n} from './ops/index.ts';\nexport type {\n  BudgetFault,\n  BudgetNaming,\n  MapTreeOp,\n  ReadCountersOp,\n  ResolvedStrategy,\n  RetrieveBytesOp,\n  Ruling,\n  SmeltBlobOp,\n  SmeltBlobOutcome,\n  StrategySource,\n  TreeNaming,\n} from './ops/index.ts';\n\n/**\n * Which planner a smelter uses, named by string. The names, their factories, and this\n * type all come from the one {@link PLANNERS} registry in `src/plan/planners.ts`, so\n * the CLI's validation and help text cannot drift from what `createSmelter` builds.\n */\nexport type { Strategy } from './plan/planners.ts';\n\nexport { createSmelter } from './smelter.ts';\nexport type { Smelter, SmelterConfig, SmeltCallOptions } from './smelter.ts';\n"]}

package/dist/setup/recipe.d.ts

@@ -0,0 +1,73 @@
+/**
+ * The SetupRecipe (CONTEXT.md): the one true way to put smelt on a machine — the
+ * install commands, the init defaults, the store default, the hooks step, the MCP
+ * registration — held as data, because prose is never the source. Every rendering
+ * derives from this module or is pinned to it by a guard
+ * (`test/guards/setup-recipe.test.ts`); the same facts used to be retyped until the
+ * store default existed under three doc spellings, one of them wrong, and the MCP
+ * registration command lived in four places at once.
+ *
+ * This module imports nothing and does nothing: it is the fact layer every setup
+ * surface reads, and the seam the `setup` verb, the skill pack, and the site's fact
+ * generator hang off.
+ */
+export declare const SETUP_RECIPE: {
+    readonly install: {
+        /** The library, into a project — npm's spelling, and its siblings beside it. */
+        readonly library: 'npm install @smeltjs/core';
+        readonly libraryPnpm: 'pnpm add @smeltjs/core';
+        readonly libraryBun: 'bun add @smeltjs/core';
+        /** The CLI, onto the machine. (Not named `global`: that word is Law 1's.) */
+        readonly globalInstall: 'npm install -g @smeltjs/core';
+        /** The CLI, without installing it. */
+        readonly oneShot: 'npx @smeltjs/core';
+        /** The CLI over Homebrew, from smelt's own tap (KOT-248 seeds it). */
+        readonly brewInstall: 'brew install smeltjs/tap/smelt';
+        /** The Homebrew upgrade — the first half of the update loop doctor completes. */
+        readonly brewUpgrade: 'brew upgrade smelt';
+        /** The SkillPack, installed by an agent's owner (ADR-0002). */
+        readonly skillInstall: 'npx skills add smeltjs/smelt';
+    };
+    /**
+     * The budget the setup path writes when its caller names none — the number every
+     * example already uses. Written loudly and recorded with its provenance; the
+     * `smelt` verb's own budget-required refusal is untouched by it.
+     */
+    readonly recommendedBudgetBytes: 4000;
+    readonly store: {
+        /** Where the persistent store lives, relative to smelt.config.json. */
+        readonly defaultDir: '.smelt/store';
+    };
+    readonly mcp: {
+        /** The MCP server, run from the project directory. */
+        readonly run: 'npx @smeltjs/mcp';
+        /**
+         * Registration as Claude Code's CLI spells it — the canonical string while the
+         * harness profiles cannot yet carry per-harness registration; the
+         * mcp-registration step kind generalizes this per harness.
+         */
+        readonly register: 'claude mcp add smelt -- npx @smeltjs/mcp';
+    };
+};
+export type SetupRecipe = typeof SETUP_RECIPE;
+/**
+ * The recipe's run command as a spawn array — derived once, beside the fact it comes
+ * from, because two harness profiles need the array and a second `.split(' ')` would
+ * be the second spelling this module exists to end.
+ */
+export declare const MCP_RUN_ARGS: readonly string[];
+/** One step of the recipe, in the order a new machine walks it. */
+export interface SetupStep {
+    readonly id: 'install' | 'init' | 'hooks' | 'mcp' | 'verify';
+    readonly title: string;
+    readonly command: string;
+}
+/**
+ * The recipe's steps, in order, ending in the verification that makes "set up" a
+ * claim with evidence. The install and MCP commands are named facts above; the init,
+ * hooks and verify steps name the verbs and the canonical invocation — the wizard
+ * each is, not a fact the recipe owns, except the budget the verify step carries,
+ * which is the recipe's.
+ */
+export declare const SETUP_STEPS: readonly SetupStep[];
+//# sourceMappingURL=recipe.d.ts.map

package/dist/setup/recipe.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"recipe.d.ts","sourceRoot":"","sources":["../../src/setup/recipe.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,YAAY;aACvB,OAAO;QACL,gFAAgF;iBAChF,OAAO,EAAE,2BAA2B;iBACpC,WAAW,EAAE,wBAAwB;iBACrC,UAAU,EAAE,uBAAuB;QACnC,6EAA6E;iBAC7E,aAAa,EAAE,8BAA8B;QAC7C,sCAAsC;iBACtC,OAAO,EAAE,mBAAmB;QAC5B,sEAAsE;iBACtE,WAAW,EAAE,gCAAgC;QAC7C,iFAAiF;iBACjF,WAAW,EAAE,oBAAoB;QACjC,+DAA+D;iBAC/D,YAAY,EAAE,8BAA8B;;IAE9C;;;;OAIG;aACH,sBAAsB,EAAE,IAAI;aAC5B,KAAK;QACH,uEAAuE;iBACvE,UAAU,EAAE,cAAc;;aAE5B,GAAG;QACD,sDAAsD;iBACtD,GAAG,EAAE,kBAAkB;QACvB;;;;WAIG;iBACH,QAAQ,EAAE,0CAA0C;;CAE9C,CAAC;AAEX,MAAM,MAAM,WAAW,GAAG,OAAO,YAAY,CAAC;AAE9C;;;;GAIG;AACH,eAAO,MAAM,YAAY,EAAE,SAAS,MAAM,EAAoC,CAAC;AAE/E,mEAAmE;AACnE,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,EAAE,EAAE,SAAS,GAAG,MAAM,GAAG,OAAO,GAAG,KAAK,GAAG,QAAQ,CAAC;IAC7D,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED;;;;;;GAMG;AACH,eAAO,MAAM,WAAW,EAAE,SAAS,SAAS,EAU3C,CAAC","sourcesContent":["/**\n * The SetupRecipe (CONTEXT.md): the one true way to put smelt on a machine — the\n * install commands, the init defaults, the store default, the hooks step, the MCP\n * registration — held as data, because prose is never the source. Every rendering\n * derives from this module or is pinned to it by a guard\n * (`test/guards/setup-recipe.test.ts`); the same facts used to be retyped until the\n * store default existed under three doc spellings, one of them wrong, and the MCP\n * registration command lived in four places at once.\n *\n * This module imports nothing and does nothing: it is the fact layer every setup\n * surface reads, and the seam the `setup` verb, the skill pack, and the site's fact\n * generator hang off.\n */\nexport const SETUP_RECIPE = {\n  install: {\n    /** The library, into a project — npm's spelling, and its siblings beside it. */\n    library: 'npm install @smeltjs/core',\n    libraryPnpm: 'pnpm add @smeltjs/core',\n    libraryBun: 'bun add @smeltjs/core',\n    /** The CLI, onto the machine. (Not named `global`: that word is Law 1's.) */\n    globalInstall: 'npm install -g @smeltjs/core',\n    /** The CLI, without installing it. */\n    oneShot: 'npx @smeltjs/core',\n    /** The CLI over Homebrew, from smelt's own tap (KOT-248 seeds it). */\n    brewInstall: 'brew install smeltjs/tap/smelt',\n    /** The Homebrew upgrade — the first half of the update loop doctor completes. */\n    brewUpgrade: 'brew upgrade smelt',\n    /** The SkillPack, installed by an agent's owner (ADR-0002). */\n    skillInstall: 'npx skills add smeltjs/smelt',\n  },\n  /**\n   * The budget the setup path writes when its caller names none — the number every\n   * example already uses. Written loudly and recorded with its provenance; the\n   * `smelt` verb's own budget-required refusal is untouched by it.\n   */\n  recommendedBudgetBytes: 4000,\n  store: {\n    /** Where the persistent store lives, relative to smelt.config.json. */\n    defaultDir: '.smelt/store',\n  },\n  mcp: {\n    /** The MCP server, run from the project directory. */\n    run: 'npx @smeltjs/mcp',\n    /**\n     * Registration as Claude Code's CLI spells it — the canonical string while the\n     * harness profiles cannot yet carry per-harness registration; the\n     * mcp-registration step kind generalizes this per harness.\n     */\n    register: 'claude mcp add smelt -- npx @smeltjs/mcp',\n  },\n} as const;\n\nexport type SetupRecipe = typeof SETUP_RECIPE;\n\n/**\n * The recipe's run command as a spawn array — derived once, beside the fact it comes\n * from, because two harness profiles need the array and a second `.split(' ')` would\n * be the second spelling this module exists to end.\n */\nexport const MCP_RUN_ARGS: readonly string[] = SETUP_RECIPE.mcp.run.split(' ');\n\n/** One step of the recipe, in the order a new machine walks it. */\nexport interface SetupStep {\n  readonly id: 'install' | 'init' | 'hooks' | 'mcp' | 'verify';\n  readonly title: string;\n  readonly command: string;\n}\n\n/**\n * The recipe's steps, in order, ending in the verification that makes \"set up\" a\n * claim with evidence. The install and MCP commands are named facts above; the init,\n * hooks and verify steps name the verbs and the canonical invocation — the wizard\n * each is, not a fact the recipe owns, except the budget the verify step carries,\n * which is the recipe's.\n */\nexport const SETUP_STEPS: readonly SetupStep[] = [\n  { id: 'install', title: 'install the CLI', command: SETUP_RECIPE.install.globalInstall },\n  { id: 'init', title: 'write smelt.config.json', command: 'smelt init' },\n  { id: 'hooks', title: 'wire the hooks preset', command: 'smelt hooks install' },\n  { id: 'mcp', title: 'register the MCP server', command: SETUP_RECIPE.mcp.register },\n  {\n    id: 'verify',\n    title: 'prove the round trip on a real file',\n    command: `smelt <file> --budget ${SETUP_RECIPE.recommendedBudgetBytes} --focus <focus>`,\n  },\n];\n"]}

package/dist/setup/recipe.js

@@ -0,0 +1,76 @@
+/**
+ * The SetupRecipe (CONTEXT.md): the one true way to put smelt on a machine — the
+ * install commands, the init defaults, the store default, the hooks step, the MCP
+ * registration — held as data, because prose is never the source. Every rendering
+ * derives from this module or is pinned to it by a guard
+ * (`test/guards/setup-recipe.test.ts`); the same facts used to be retyped until the
+ * store default existed under three doc spellings, one of them wrong, and the MCP
+ * registration command lived in four places at once.
+ *
+ * This module imports nothing and does nothing: it is the fact layer every setup
+ * surface reads, and the seam the `setup` verb, the skill pack, and the site's fact
+ * generator hang off.
+ */
+export const SETUP_RECIPE = {
+    install: {
+        /** The library, into a project — npm's spelling, and its siblings beside it. */
+        library: 'npm install @smeltjs/core',
+        libraryPnpm: 'pnpm add @smeltjs/core',
+        libraryBun: 'bun add @smeltjs/core',
+        /** The CLI, onto the machine. (Not named `global`: that word is Law 1's.) */
+        globalInstall: 'npm install -g @smeltjs/core',
+        /** The CLI, without installing it. */
+        oneShot: 'npx @smeltjs/core',
+        /** The CLI over Homebrew, from smelt's own tap (KOT-248 seeds it). */
+        brewInstall: 'brew install smeltjs/tap/smelt',
+        /** The Homebrew upgrade — the first half of the update loop doctor completes. */
+        brewUpgrade: 'brew upgrade smelt',
+        /** The SkillPack, installed by an agent's owner (ADR-0002). */
+        skillInstall: 'npx skills add smeltjs/smelt',
+    },
+    /**
+     * The budget the setup path writes when its caller names none — the number every
+     * example already uses. Written loudly and recorded with its provenance; the
+     * `smelt` verb's own budget-required refusal is untouched by it.
+     */
+    recommendedBudgetBytes: 4000,
+    store: {
+        /** Where the persistent store lives, relative to smelt.config.json. */
+        defaultDir: '.smelt/store',
+    },
+    mcp: {
+        /** The MCP server, run from the project directory. */
+        run: 'npx @smeltjs/mcp',
+        /**
+         * Registration as Claude Code's CLI spells it — the canonical string while the
+         * harness profiles cannot yet carry per-harness registration; the
+         * mcp-registration step kind generalizes this per harness.
+         */
+        register: 'claude mcp add smelt -- npx @smeltjs/mcp',
+    },
+};
+/**
+ * The recipe's run command as a spawn array — derived once, beside the fact it comes
+ * from, because two harness profiles need the array and a second `.split(' ')` would
+ * be the second spelling this module exists to end.
+ */
+export const MCP_RUN_ARGS = SETUP_RECIPE.mcp.run.split(' ');
+/**
+ * The recipe's steps, in order, ending in the verification that makes "set up" a
+ * claim with evidence. The install and MCP commands are named facts above; the init,
+ * hooks and verify steps name the verbs and the canonical invocation — the wizard
+ * each is, not a fact the recipe owns, except the budget the verify step carries,
+ * which is the recipe's.
+ */
+export const SETUP_STEPS = [
+    { id: 'install', title: 'install the CLI', command: SETUP_RECIPE.install.globalInstall },
+    { id: 'init', title: 'write smelt.config.json', command: 'smelt init' },
+    { id: 'hooks', title: 'wire the hooks preset', command: 'smelt hooks install' },
+    { id: 'mcp', title: 'register the MCP server', command: SETUP_RECIPE.mcp.register },
+    {
+        id: 'verify',
+        title: 'prove the round trip on a real file',
+        command: `smelt <file> --budget ${SETUP_RECIPE.recommendedBudgetBytes} --focus <focus>`,
+    },
+];
+//# sourceMappingURL=recipe.js.map

package/dist/setup/recipe.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"recipe.js","sourceRoot":"","sources":["../../src/setup/recipe.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG;IAC1B,OAAO,EAAE;QACP,gFAAgF;QAChF,OAAO,EAAE,2BAA2B;QACpC,WAAW,EAAE,wBAAwB;QACrC,UAAU,EAAE,uBAAuB;QACnC,6EAA6E;QAC7E,aAAa,EAAE,8BAA8B;QAC7C,sCAAsC;QACtC,OAAO,EAAE,mBAAmB;QAC5B,sEAAsE;QACtE,WAAW,EAAE,gCAAgC;QAC7C,iFAAiF;QACjF,WAAW,EAAE,oBAAoB;QACjC,+DAA+D;QAC/D,YAAY,EAAE,8BAA8B;KAC7C;IACD;;;;OAIG;IACH,sBAAsB,EAAE,IAAI;IAC5B,KAAK,EAAE;QACL,uEAAuE;QACvE,UAAU,EAAE,cAAc;KAC3B;IACD,GAAG,EAAE;QACH,sDAAsD;QACtD,GAAG,EAAE,kBAAkB;QACvB;;;;WAIG;QACH,QAAQ,EAAE,0CAA0C;KACrD;CACO,CAAC;AAIX;;;;GAIG;AACH,MAAM,CAAC,MAAM,YAAY,GAAsB,YAAY,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;AAS/E;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,WAAW,GAAyB;IAC/C,EAAE,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE,iBAAiB,EAAE,OAAO,EAAE,YAAY,CAAC,OAAO,CAAC,aAAa,EAAE;IACxF,EAAE,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,yBAAyB,EAAE,OAAO,EAAE,YAAY,EAAE;IACvE,EAAE,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,uBAAuB,EAAE,OAAO,EAAE,qBAAqB,EAAE;IAC/E,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,yBAAyB,EAAE,OAAO,EAAE,YAAY,CAAC,GAAG,CAAC,QAAQ,EAAE;IACnF;QACE,EAAE,EAAE,QAAQ;QACZ,KAAK,EAAE,qCAAqC;QAC5C,OAAO,EAAE,yBAAyB,YAAY,CAAC,sBAAsB,kBAAkB;KACxF;CACF,CAAC","sourcesContent":["/**\n * The SetupRecipe (CONTEXT.md): the one true way to put smelt on a machine — the\n * install commands, the init defaults, the store default, the hooks step, the MCP\n * registration — held as data, because prose is never the source. Every rendering\n * derives from this module or is pinned to it by a guard\n * (`test/guards/setup-recipe.test.ts`); the same facts used to be retyped until the\n * store default existed under three doc spellings, one of them wrong, and the MCP\n * registration command lived in four places at once.\n *\n * This module imports nothing and does nothing: it is the fact layer every setup\n * surface reads, and the seam the `setup` verb, the skill pack, and the site's fact\n * generator hang off.\n */\nexport const SETUP_RECIPE = {\n  install: {\n    /** The library, into a project — npm's spelling, and its siblings beside it. */\n    library: 'npm install @smeltjs/core',\n    libraryPnpm: 'pnpm add @smeltjs/core',\n    libraryBun: 'bun add @smeltjs/core',\n    /** The CLI, onto the machine. (Not named `global`: that word is Law 1's.) */\n    globalInstall: 'npm install -g @smeltjs/core',\n    /** The CLI, without installing it. */\n    oneShot: 'npx @smeltjs/core',\n    /** The CLI over Homebrew, from smelt's own tap (KOT-248 seeds it). */\n    brewInstall: 'brew install smeltjs/tap/smelt',\n    /** The Homebrew upgrade — the first half of the update loop doctor completes. */\n    brewUpgrade: 'brew upgrade smelt',\n    /** The SkillPack, installed by an agent's owner (ADR-0002). */\n    skillInstall: 'npx skills add smeltjs/smelt',\n  },\n  /**\n   * The budget the setup path writes when its caller names none — the number every\n   * example already uses. Written loudly and recorded with its provenance; the\n   * `smelt` verb's own budget-required refusal is untouched by it.\n   */\n  recommendedBudgetBytes: 4000,\n  store: {\n    /** Where the persistent store lives, relative to smelt.config.json. */\n    defaultDir: '.smelt/store',\n  },\n  mcp: {\n    /** The MCP server, run from the project directory. */\n    run: 'npx @smeltjs/mcp',\n    /**\n     * Registration as Claude Code's CLI spells it — the canonical string while the\n     * harness profiles cannot yet carry per-harness registration; the\n     * mcp-registration step kind generalizes this per harness.\n     */\n    register: 'claude mcp add smelt -- npx @smeltjs/mcp',\n  },\n} as const;\n\nexport type SetupRecipe = typeof SETUP_RECIPE;\n\n/**\n * The recipe's run command as a spawn array — derived once, beside the fact it comes\n * from, because two harness profiles need the array and a second `.split(' ')` would\n * be the second spelling this module exists to end.\n */\nexport const MCP_RUN_ARGS: readonly string[] = SETUP_RECIPE.mcp.run.split(' ');\n\n/** One step of the recipe, in the order a new machine walks it. */\nexport interface SetupStep {\n  readonly id: 'install' | 'init' | 'hooks' | 'mcp' | 'verify';\n  readonly title: string;\n  readonly command: string;\n}\n\n/**\n * The recipe's steps, in order, ending in the verification that makes \"set up\" a\n * claim with evidence. The install and MCP commands are named facts above; the init,\n * hooks and verify steps name the verbs and the canonical invocation — the wizard\n * each is, not a fact the recipe owns, except the budget the verify step carries,\n * which is the recipe's.\n */\nexport const SETUP_STEPS: readonly SetupStep[] = [\n  { id: 'install', title: 'install the CLI', command: SETUP_RECIPE.install.globalInstall },\n  { id: 'init', title: 'write smelt.config.json', command: 'smelt init' },\n  { id: 'hooks', title: 'wire the hooks preset', command: 'smelt hooks install' },\n  { id: 'mcp', title: 'register the MCP server', command: SETUP_RECIPE.mcp.register },\n  {\n    id: 'verify',\n    title: 'prove the round trip on a real file',\n    command: `smelt <file> --budget ${SETUP_RECIPE.recommendedBudgetBytes} --focus <focus>`,\n  },\n];\n"]}