@the-i18n-kit/cli 6.0.0 → 7.0.0

package/README.md

@@ -5,7 +5,7 @@
 
 Find missing translation keys, remove dead ones, and rename across every locale
 and layer at once. Supports Nuxt, Laravel, Vue, React/Next.js, and any project
-with JSON or PHP locale files.
+with JSON, YAML or PHP locale files.
 
 Part of [the-i18n-kit](https://github.com/fabkho/the-i18n-kit).
 
@@ -26,7 +26,7 @@ the-i18n-cli init                    # write a config from what it detects
 the-i18n-cli status                  # coverage per locale and per layer
 the-i18n-cli missing                 # what is not translated yet
 the-i18n-cli check                   # keys used in code but defined nowhere
-the-i18n-cli remove-orphans          # keys defined but unused (previews by default)
+the-i18n-cli orphans                 # keys defined but unused (reports; --remove deletes)
 ```
 
 → [Cold start guide](https://fabkho.github.io/the-i18n-kit/getting-started/cold-start) ·
@@ -38,64 +38,14 @@ the-i18n-cli remove-orphans          # keys defined but unused (previews by defa
 | | |
 |---|---|
 | [Commands](https://fabkho.github.io/the-i18n-kit/reference/cli) | Generated from the command definitions |
+| [Agent contract](https://fabkho.github.io/the-i18n-kit/getting-started/agent-contract) | Exit codes, gates, failure reasons, output diversion, env vars |
 | [Configuration](https://fabkho.github.io/the-i18n-kit/configuration/where-config-lives) | Where it lives, precedence, [every field](https://fabkho.github.io/the-i18n-kit/configuration/reference) |
-| [Frameworks](https://fabkho.github.io/the-i18n-kit/frameworks/detection) | How detection works, and what each adapter reads |
-| [Monorepos and layers](https://fabkho.github.io/the-i18n-kit/monorepos/layers) | Why usage in one app does not protect a key in another |
-| [Referring to locales](https://fabkho.github.io/the-i18n-kit/configuration/locale-refs) | Codes, language tags, and why the code is the one to use |
+| [Frameworks](https://fabkho.github.io/the-i18n-kit/frameworks/detection) | What each adapter reads, and how to pin one |
+| [Monorepos and layers](https://fabkho.github.io/the-i18n-kit/monorepos/layers-and-consumer-graph) | Why usage in one app does not protect a key in another |
+| [Orphan detection](https://fabkho.github.io/the-i18n-kit/monorepos/orphan-detection) | What the scanner sees, its blind spots, and the call-site style that keeps a report specific |
+| [Translation modes](https://fabkho.github.io/the-i18n-kit/concepts/translation-modes) | Provider and agent mode, and what is validated before writing |
 | [CI/CD](https://fabkho.github.io/the-i18n-kit/ci-cd/github-actions) | The Action and the GitLab template |
 
-| [Translation modes](https://fabkho.github.io/the-i18n-kit/concepts/translation-modes) | Provider and agent mode, the result contract, what is validated before writing |
-
-The section below has not moved to the site yet. It is the deepest material
-here, and it is being rewritten against the new extraction architecture — see
-[#358](https://github.com/fabkho/the-i18n-kit/issues/358).
-
-
-## How Orphan Detection Works
-
-`remove-orphans` and `check` share a line-based static scanner. Knowing exactly what it can and cannot see is essential before deleting keys.
-
-**Usage evidence the scanner recognizes:**
-
-| Class | Example | Effect |
-|---|---|---|
-| Static keys | `t('a.b.c')`, `$te('a.b')`, `__('a.b')` | exact match |
-| Template patterns | `` t(`a.b.${x}`) `` | keys matching `a.b.<one segment>` count as used (`dynamic-matched`) |
-| Same-file const prefixes | `const base = 'a.b'` + `` t(`${base}.title`) `` | resolved to the exact key |
-| Unresolved variable segments | `` t(`${somePath}.title`) `` | conservatively matches **any** `*.title` key |
-| Concat prefixes | `'a.b.' + x`, `x + '.label'` | pattern-matched like templates (single-segment prefixes included) |
-| Multiline calls | prefix on a different line than `t(` | caught by bare-string fallbacks (heuristic) |
-| Multi-app scoping | key in a shared layer | usage counts only from apps that consume the layer; cross-app usages are reported as `misplacedUsages`, never removed |
-
-**The scan never removes a key it is unsure about.** Dynamic references are detected, not ignored: a key that *could* be produced by a template pattern, a concatenated prefix or an ambiguous probe is classified as used and left alone. Deletion is reserved for keys with no evidence of use anywhere in a consuming app. On a real 8,000-key project roughly 12% of keys land in the protective buckets — that is the scan working, not failing.
-
-**Classification buckets** — only `orphanKeys` is ever removed; everything else is protective:
-
-- `orphanKeys` — no evidence of use in any consuming app: safe to remove
-- `dynamic-matched` — a dynamic pattern could produce this key: counted as used
-- `uncertainKeys` — evidence is ambiguous (e.g. `$te`-only probes): never removed
-- `ignored` — matched by `orphanScan.ignorePatterns`: never scanned
-- `misplacedUsages` — used only from non-consuming apps: never removed
-
-**Known blind spots** (declare these families in `orphanScan.ignorePatterns`):
-
-- Prefixes stored in **cross-file** constants, class fields, or object properties typed as plain strings (`obj.translationPath`) — the scanner widens these to conservative suffix patterns, but treat such families as declared-dynamic
-- Keys composed at runtime from data (API responses, database values, enums built dynamically)
-- Keys referenced only outside the scanned source (backend responses, external configs, docs)
-
-**Recommended code style — anchor dynamic keys, don't avoid them.** Dynamic keys are tracked and are often the right design; what matters is that the *namespace* stays literal at the call site:
-
-```ts
-t(`${prefix}.title`)                          // widens to any key ending .title
-t(`components.integrations.${type}.title`)    // widens to one segment under a known namespace
-```
-
-Both are counted as used, but the first suppresses every `.title` key in the project — on a large catalog that can be hundreds of keys the scan can no longer audit. Keeping a literal leading segment costs nothing and keeps the report meaningful. Literal key maps (`const KEYS = { draft: 'x.status.draft' } as const`) are the fully-static alternative where the set is closed.
-
-Prefixes assembled in another scope defeat this even when they are literal — a `computed` returning `'a.b.' + x` reaches the call site as an opaque variable. Inline the namespace instead of the whole key.
-
-`remove-orphans` is dry-run by default; run removals as a reviewed MR and treat the report's `uncertainKeys`/`dynamicKeys` sections as the audit trail.
-
 ## License
 
 [MIT](https://github.com/fabkho/the-i18n-kit/blob/main/LICENSE)

package/dist/bin.js

@@ -3,7 +3,7 @@ import { t as guardStdout } from "./stdout-guard-sJHFWVem.js";
 //#region src/bin.ts
 const args = process.argv.slice(2);
 if (!(args.includes("--help") || args.includes("-h") || args.includes("--version") || args.includes("-v"))) guardStdout();
-const { runCli } = await import("./cli-CnZNGUGu.js");
+const { runCli } = await import("./cli-waEjbUM1.js");
 await runCli();
 //#endregion
 export {};

package/dist/{_shared-CkMAydRl.js → cli-waEjbUM1.js}

@@ -1,9 +1,19 @@
 import { n as writeResult } from "./stdout-guard-sJHFWVem.js";
 import { i as toErrorMessage } from "./errors-coI1dhw1.js";
-import { a as resolveProviderBaseUrl, i as createTranslateFn, l as log, s as loadProjectConfig, t as BASE_URL_ENV } from "./providers-CAsU_aV1.js";
-import { defineCommand } from "citty";
+import { a as resolveProviderBaseUrl, i as createTranslateFn, t as BASE_URL_ENV } from "./providers-BbVPelvp.js";
+import { i as log, n as loadProjectConfig } from "./project-config-C3ao4Uii.js";
+import { i as divertToReport, t as descriptors } from "./descriptors-10sgyqEs.js";
+import { createRequire } from "node:module";
+import { defineCommand, runCommand, runMain } from "citty";
 //#region src/commands/_shared.ts
-/** Factory for commands that call an operation and output its result. */
+/**
+* Factory for commands that call an operation and output its result.
+*
+* Reached through `commandFromDescriptor`, which is the only production caller:
+* it stays a separate function because output handling, gate evaluation and
+* exit codes are worth testing against a fixed result rather than against a
+* project on disk.
+*/
 function createCommand(opts) {
 	return withGates(defineCommand({
 		meta: {
@@ -18,7 +28,7 @@ function createCommand(opts) {
 			try {
 				const result = await opts.run(args);
 				const decision = resolveExitCode(result, requestedGates(opts.gates ?? [], args), isTotalFailure(result));
-				outputResult(withGateReport(result, decision.tripped), args);
+				outputResult(withGateReport(opts.divert === void 0 ? result : await opts.divert(result, args), decision.tripped), args);
 				if (decision.code !== 0) process.exitCode = decision.code;
 			} catch (error) {
 				emitErrorResult(error, args);
@@ -56,8 +66,9 @@ function resolveExitCode(result, gates, runFailed = false) {
 	};
 }
 /**
-* Read a gate's counter off result.summary. Works on inline results and on
-* the { reportFile, summary } shape alike, since both carry the summary.
+* Read a gate's counter off result.summary. Gates are evaluated before a result
+* is diverted to a file, so this sees the whole result — and it still reads the
+* { reportFile, summary } shape, which carries the same summary.
 * A missing or non-numeric counter yields undefined and never trips a gate.
 */
 function observedValue(result, counter) {
@@ -182,26 +193,104 @@ function errorCode(error) {
 	}
 	return "UNKNOWN_ERROR";
 }
-/** Provider selection flags shared by the translate commands. */
-const providerArgs = {
-	provider: {
-		type: "string",
-		description: "LLM provider: \"openai\", \"anthropic\", or \"google\". Required for automatic translation.",
-		valueHint: "openai|anthropic|google"
-	},
-	model: {
-		type: "string",
-		description: "Model name (required when --provider is set)"
-	},
-	apiKey: {
-		type: "string",
-		description: "API key (falls back to OPENAI_API_KEY / ANTHROPIC_API_KEY / GEMINI_API_KEY env)."
-	},
-	baseUrl: {
-		type: "string",
-		description: `Provider base URL for gateways, self-hosted models and proxies speaking the provider's protocol. Falls back to ${BASE_URL_ENV}, then providerBaseUrl in .i18n-mcp.json. Not supported by "google".`
+/**
+* The citty command for one descriptor: its flags, its gates, and a run that
+* hands the operation arguments of the types the descriptor declared.
+*
+* Everything a command needs is read off the descriptor, so a command is not a
+* file anyone writes — which is what keeps it from drifting from the tool that
+* runs the same operation.
+*/
+function commandFromDescriptor(descriptor) {
+	const cli = descriptor.cli;
+	if (cli === null) throw new Error(`Operation "${descriptor.id}" declares no CLI command.`);
+	return createCommand({
+		name: cli.name,
+		description: descriptor.description,
+		args: cliArgs(descriptor.params),
+		gates: descriptor.gates,
+		run: async (args) => descriptor.run(operationArgs(descriptor.params, args), {
+			surface: "cli",
+			translateFn: descriptor.usesTranslateFn === true ? await resolveProviderTranslateFn(args) : void 0
+		}),
+		divert: async (result, args) => divertToReport(result, descriptor, operationArgs(descriptor.params, args))
+	});
+}
+/** The citty `args` for a descriptor's parameters, skipping the CLI-hidden ones. */
+function cliArgs(params) {
+	const args = {};
+	for (const [name, spec] of Object.entries(params)) {
+		if (spec.cli?.hidden === true) continue;
+		args[name] = {
+			type: spec.type === "boolean" ? "boolean" : "string",
+			description: flagDescription(spec),
+			...spec.required === true ? { required: true } : {},
+			...spec.default === void 0 ? {} : { default: spec.default },
+			...spec.cli?.alias === void 0 ? {} : { alias: [...toArray(spec.cli.alias)] },
+			...spec.enum === void 0 ? {} : { valueHint: spec.enum.join("|") }
+		};
 	}
-};
+	return args;
+}
+/**
+* The description a flag prints. The declared one is written for a reader of
+* either surface, so how to spell a list or an object at a shell prompt is
+* added here rather than in every spec.
+*/
+function flagDescription(spec) {
+	if (spec.type === "string[]") return `${spec.description} Comma-separated${spec.allowAll === true ? ", or \"all\"" : ""}.`;
+	if (spec.type === "record") return `${spec.description} Pass it as JSON.`;
+	return spec.description;
+}
+/**
+* citty's parsed args as the operation takes them: lists split, numbers and
+* JSON parsed, enums checked. `projectDir` comes along because every operation
+* accepts it without declaring it.
+*/
+function operationArgs(params, args) {
+	const operation = { projectDir: args.projectDir };
+	for (const [name, spec] of Object.entries(params)) {
+		if (spec.cli?.hidden === true) continue;
+		const value = coerce(name, spec, args[name]);
+		if (value !== void 0) operation[name] = value;
+	}
+	return operation;
+}
+function coerce(name, spec, raw) {
+	if (spec.type === "boolean") return typeof raw === "boolean" ? raw : void 0;
+	const value = typeof raw === "string" ? raw : void 0;
+	switch (spec.type) {
+		case "number": return value === void 0 || value === "" ? void 0 : toNumber(name, spec, value);
+		case "string[]": return toList(name, spec, value);
+		case "record": return value === void 0 ? void 0 : parseJsonArg(value, name);
+		default: return toEnumChecked(name, spec, value);
+	}
+}
+function toEnumChecked(name, spec, value) {
+	if (spec.enum === void 0) return value;
+	if (value === void 0 || value === "") return void 0;
+	if (!spec.enum.includes(value)) throw new Error(`Invalid --${name} value: "${value}". Must be one of: ${spec.enum.join(", ")}`);
+	return value;
+}
+function toNumber(name, spec, raw) {
+	const value = Number(raw);
+	if (!(Number.isFinite(value) && (spec.integer !== true || Number.isInteger(value) && String(value) === raw.trim()) && (spec.min === void 0 || value >= spec.min))) throw new Error(`Invalid --${name}: "${raw}". Must be ${numberRequirement(spec)}`);
+	return value;
+}
+function numberRequirement(spec) {
+	if (spec.integer !== true) return spec.min === void 0 ? "a number" : `a number of at least ${spec.min}`;
+	if (spec.min === 1) return "a positive integer";
+	return spec.min === void 0 ? "an integer" : `an integer of at least ${spec.min}`;
+}
+function toList(name, spec, raw) {
+	if (spec.allowAll === true && raw === "all") return "all";
+	const list = splitList(raw);
+	if ((list === void 0 || list.length === 0) && (spec.required === true || raw !== void 0 && raw !== "")) throw new Error(`No ${name} provided. Pass a comma-separated list via --${name}.`);
+	return list;
+}
+function toArray(value) {
+	return typeof value === "string" ? [value] : value;
+}
 /**
 * Build a TranslateFn from the provider flags, or undefined when no provider
 * was given (agent mode). The base URL resolves flag > env > project config;
@@ -255,6 +344,47 @@ function parseJsonArg(value, argName) {
 	}
 }
 //#endregion
-export { resolveProviderTranslateFn as a, providerArgs as i, emitErrorResult as n, splitList as o, parseJsonArg as r, createCommand as t };
+//#region src/commands/index.ts
+function entry(build) {
+	let built;
+	return { load: async () => built ??= build() };
+}
+function registry() {
+	const commands = {};
+	for (const descriptor of descriptors) {
+		const cli = descriptor.cli;
+		if (cli === null) continue;
+		commands[cli.name] = entry(() => commandFromDescriptor(descriptor));
+	}
+	return commands;
+}
+const commands$1 = registry();
+//#endregion
+//#region src/cli.ts
+const commands = Object.fromEntries(Object.entries(commands$1).map(([name, entry]) => [name, entry.load]));
+const { version, description } = createRequire(import.meta.url)("../package.json");
+const main = defineCommand({
+	meta: {
+		name: "the-i18n-cli",
+		version,
+		description
+	},
+	subCommands: commands
+});
+async function runCli() {
+	const rawArgs = process.argv.slice(2);
+	if (rawArgs.includes("--help") || rawArgs.includes("-h") || rawArgs.includes("--version") || rawArgs.includes("-v")) {
+		await runMain(main);
+		return;
+	}
+	try {
+		await runCommand(main, { rawArgs });
+	} catch (error) {
+		emitErrorResult(error, { json: rawArgs.includes("--json") });
+		process.exitCode = 1;
+	}
+}
+//#endregion
+export { runCli };
 
-//# sourceMappingURL=_shared-CkMAydRl.js.map
+//# sourceMappingURL=cli-waEjbUM1.js.map

package/dist/cli-waEjbUM1.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-waEjbUM1.js","names":["commands","allCommands"],"sources":["../src/commands/_shared.ts","../src/commands/index.ts","../src/cli.ts"],"sourcesContent":["import { defineCommand } from 'citty'\nimport type { CommandDef } from 'citty'\nimport { log } from '../utils/logger.js'\nimport { toErrorMessage } from '../utils/errors.js'\nimport { writeResult } from '../utils/stdout-guard.js'\nimport { createTranslateFn, resolveProviderBaseUrl, BASE_URL_ENV } from '../llm/providers.js'\nimport type { LlmProvider } from '../llm/providers.js'\nimport type { TranslateFn } from '../core/types.js'\nimport { loadProjectConfig } from '../config/project-config.js'\nimport { divertToReport } from '../surface/report.js'\nimport type {\n  AnyOperationDescriptor,\n  FlaggedGateSpec,\n  GateSpec,\n  ParamSpec,\n  Params,\n} from '../surface/types.js'\n\n// Declared with the descriptors, since a gate is something an operation\n// declares; re-exported here because this is where they are evaluated and\n// where the reference generator reads the exit codes from.\nexport type { GateSpec, FlaggedGateSpec, AlwaysOnGateSpec } from '../surface/types.js'\n\n/**\n * Factory for commands that call an operation and output its result.\n *\n * Reached through `commandFromDescriptor`, which is the only production caller:\n * it stays a separate function because output handling, gate evaluation and\n * exit codes are worth testing against a fixed result rather than against a\n * project on disk.\n */\nexport function createCommand(opts: {\n  name: string\n  description: string\n  args?: Record<string, unknown>\n  /**\n   * CI gates this command evaluates. The factory reads the requesting flag off\n   * args and evaluates every gate uniformly, so no command grows bespoke exit\n   * logic. Declaring a flagged gate does not add its flag — pair each spec\n   * with an entry in `args`. A spec without a flag is always evaluated.\n   */\n  gates?: GateSpec[]\n  /**\n   * Receives citty's parsed args. `any` is deliberate: the `args` above are\n   * built at runtime from a descriptor's parameters and citty does not thread\n   * that type through to the handler. The typed view of these arguments is the\n   * descriptor's own `run`, which `commandFromDescriptor` calls with values\n   * already coerced to the declared types.\n   */\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any -- see above\n  run: (args: any) => Promise<unknown>\n  /**\n   * Applied to the result after the gates have been evaluated. That order is\n   * the point: a run that writes its result to a file still exits on the\n   * counters that result carried, so `--output-file` and a gate flag combine\n   * the way a pipeline expects.\n   */\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any -- as above\n  divert?: (result: unknown, args: any) => Promise<unknown>\n}): CommandDef {\n  // Retained on the definition, not only consumed here: the generated CLI\n  // reference has to state which commands fail a build on findings, and a gate\n  // with no flag leaves no trace in the arg descriptions to infer it from.\n  return withGates(defineCommand({\n    meta: { name: opts.name, description: opts.description },\n    args: { ...sharedArgs, ...(opts.args ?? {}) },\n    async run({ args }) {\n      try {\n        const result = await opts.run(args)\n        const decision = resolveExitCode(result, requestedGates(opts.gates ?? [], args), isTotalFailure(result))\n        const output = opts.divert === undefined ? result : await opts.divert(result, args)\n        outputResult(withGateReport(output, decision.tripped), args)\n        // Assign only on a non-zero decision: a clean run must leave the exit\n        // code exactly as it found it, as it did before gates existed.\n        if (decision.code !== EXIT_SUCCESS) process.exitCode = decision.code\n      } catch (error) {\n        emitErrorResult(error, args)\n        process.exitCode = EXIT_RUN_FAILED\n      }\n    },\n  }) as CommandDef, opts.gates ?? [])\n}\n\n/**\n * A command definition carrying the gates its factory evaluates. Read\n * structurally by the reference generator rather than by importing this type,\n * which would make the docs build depend on the CLI's internals.\n */\ninterface GatedCommandDef extends CommandDef {\n  gates: GateSpec[]\n}\n\nfunction withGates(def: CommandDef, gates: GateSpec[]): GatedCommandDef {\n  return Object.assign(def, { gates })\n}\n\n/** The run succeeded and no gate tripped. */\nexport const EXIT_SUCCESS = 0\n/** The run itself failed — a bad API key, an unreadable project, a total translate failure. */\nexport const EXIT_RUN_FAILED = 1\n/** The run succeeded but a requested gate tripped — findings exist, the tool worked. */\nexport const EXIT_GATE_TRIPPED = 2\n\n/** A gate the caller asked for, with its threshold already resolved. */\nexport interface RequestedGate {\n  name: string\n  counter: string\n  direction: 'above' | 'below'\n  threshold: number\n}\n\n/** A gate that tripped, as reported in the result. */\nexport interface TrippedGate extends RequestedGate {\n  observed: number\n}\n\nexport interface ExitDecision {\n  code: typeof EXIT_SUCCESS | typeof EXIT_RUN_FAILED | typeof EXIT_GATE_TRIPPED\n  tripped: TrippedGate[]\n}\n\n/**\n * Pure decision from an operation result plus the gates the caller requested\n * to an exit code. A failed run outranks a tripped gate — exit 1 wins over\n * exit 2 — and gates are not even consulted in that case, because counters\n * from a run that fell over say nothing about the project.\n */\nexport function resolveExitCode(\n  result: unknown,\n  gates: RequestedGate[],\n  runFailed = false,\n): ExitDecision {\n  if (runFailed) return { code: EXIT_RUN_FAILED, tripped: [] }\n\n  const tripped: TrippedGate[] = []\n  for (const gate of gates) {\n    const observed = observedValue(result, gate.counter)\n    if (observed === undefined || !trips(gate, observed)) continue\n    tripped.push({ ...gate, observed })\n  }\n\n  return {\n    code: tripped.length > 0 ? EXIT_GATE_TRIPPED : EXIT_SUCCESS,\n    tripped,\n  }\n}\n\n/**\n * Read a gate's counter off result.summary. Gates are evaluated before a result\n * is diverted to a file, so this sees the whole result — and it still reads the\n * { reportFile, summary } shape, which carries the same summary.\n * A missing or non-numeric counter yields undefined and never trips a gate.\n */\nfunction observedValue(result: unknown, counter: string): number | undefined {\n  if (result === null || typeof result !== 'object') return undefined\n  const summary = (result as Record<string, unknown>).summary\n  if (summary === null || typeof summary !== 'object') return undefined\n  const value = (summary as Record<string, unknown>)[counter]\n  return typeof value === 'number' && Number.isFinite(value) ? value : undefined\n}\n\nfunction trips(gate: RequestedGate, observed: number): boolean {\n  return gate.direction === 'below' ? observed < gate.threshold : observed > gate.threshold\n}\n\n/** Filter the declared gates down to the ones this invocation asked for. */\nfunction requestedGates(specs: GateSpec[], args: Record<string, unknown>): RequestedGate[] {\n  const requested: RequestedGate[] = []\n  for (const spec of specs) {\n    const resolved = spec.flag === undefined\n      ? { name: spec.name, threshold: spec.threshold }\n      : { name: kebabCase(spec.flag), threshold: thresholdFromFlag(spec, args) }\n    if (resolved.threshold === undefined || !Number.isFinite(resolved.threshold)) continue\n    requested.push({\n      name: resolved.name,\n      counter: spec.counter,\n      direction: spec.direction ?? 'above',\n      threshold: resolved.threshold,\n    })\n  }\n  return requested\n}\n\n/** The gate's threshold, or undefined when this invocation did not ask for it. */\nfunction thresholdFromFlag(spec: FlaggedGateSpec, args: Record<string, unknown>): number | undefined {\n  const raw = args[spec.flag]\n  if (raw === undefined || raw === null || raw === false || raw === '') return undefined\n  return spec.threshold ?? Number(raw)\n}\n\n/**\n * Name a tripped gate by the flag that requested it, so the JSON says\n * \"fail-on-missing\" — what the user typed — rather than \"failOnMissing\".\n */\nfunction kebabCase(flag: string): string {\n  return flag.replace(/[A-Z]/g, c => `-${c.toLowerCase()}`)\n}\n\n/**\n * Attach the gate report without disturbing the rest of the result: consumers\n * parsing today's shape keep working, and a run where nothing tripped is\n * byte-for-byte what it was before gates existed.\n */\nfunction withGateReport(result: unknown, tripped: TrippedGate[]): unknown {\n  if (tripped.length === 0) return result\n  if (result === null || typeof result !== 'object' || Array.isArray(result)) return result\n  return { ...(result as Record<string, unknown>), gatesTripped: tripped }\n}\n\n/**\n * True when a run completed but achieved nothing: failures present and zero\n * successes. Covers translate-missing-style results (summary.totalFailed /\n * summary.totalTranslated) and translate-key-style results (top-level\n * failed[] / translated[]). Results without those fields are never a\n * total failure, so unrelated commands are unaffected.\n */\nexport function isTotalFailure(result: unknown): boolean {\n  if (result === null || typeof result !== 'object') return false\n  const r = result as Record<string, unknown>\n\n  const summary = r.summary\n  if (summary !== null && typeof summary === 'object') {\n    const s = summary as Record<string, unknown>\n    if (typeof s.totalFailed === 'number' && typeof s.totalTranslated === 'number') {\n      return s.totalFailed > 0 && s.totalTranslated === 0\n    }\n  }\n\n  if (Array.isArray(r.failed) && Array.isArray(r.translated)) {\n    return r.failed.length > 0 && r.translated.length === 0\n  }\n\n  return false\n}\n\nconst sharedArgs = {\n  projectDir: {\n    type: 'string' as const,\n    alias: 'd',\n    description: 'Project directory (default: cwd)',\n  },\n  json: {\n    type: 'boolean' as const,\n    description: 'Output as JSON (default for non-TTY)',\n    default: false,\n  },\n}\n\n/** Output result — stdout always carries the result, machine-parseable when piped/--json */\nfunction outputResult(data: unknown, args: { json?: boolean }): void {\n  const jsonMode = args.json || !process.stdout.isTTY\n  if (\n    !jsonMode &&\n    data !== null &&\n    typeof data === 'object' &&\n    'reportFile' in (data as Record<string, unknown>)\n  ) {\n    const { reportFile, ...rest } = data as Record<string, unknown>\n    log.info(`Wrote report to: ${reportFile}`)\n    writeResult(JSON.stringify(rest, null, 2) + '\\n')\n    return\n  }\n  // JSON mode emits the full result (including reportFile when present) as pure JSON\n  writeResult(JSON.stringify(data, null, 2) + '\\n')\n}\n\n/**\n * Failure output. In JSON mode stdout must still carry parseable JSON —\n * consumers pipe it into jq, and zero bytes is a parse error — so the\n * structured error object IS the result on stdout; the human-readable\n * message goes to stderr in every mode. Exit code stays non-zero (callers\n * set it).\n */\nexport function emitErrorResult(error: unknown, args: { json?: boolean }): void {\n  log.error(toErrorMessage(error))\n  const jsonMode = args.json || !process.stdout.isTTY\n  if (!jsonMode) return\n  const payload = { error: { code: errorCode(error), message: toErrorMessage(error) } }\n  writeResult(JSON.stringify(payload, null, 2) + '\\n')\n}\n\n/** ToolError/FileIOError carry codes; Node errors expose e.g. ENOENT. */\nfunction errorCode(error: unknown): string {\n  if (error instanceof Error) {\n    const code = (error as { code?: unknown }).code\n    if (typeof code === 'string') return code\n    if (error.name === 'ConfigError') return 'CONFIG_ERROR'\n  }\n  return 'UNKNOWN_ERROR'\n}\n\n/**\n * The citty command for one descriptor: its flags, its gates, and a run that\n * hands the operation arguments of the types the descriptor declared.\n *\n * Everything a command needs is read off the descriptor, so a command is not a\n * file anyone writes — which is what keeps it from drifting from the tool that\n * runs the same operation.\n */\nexport function commandFromDescriptor(descriptor: AnyOperationDescriptor): CommandDef {\n  const cli = descriptor.cli\n  if (cli === null) {\n    throw new Error(`Operation \"${descriptor.id}\" declares no CLI command.`)\n  }\n\n  return createCommand({\n    name: cli.name,\n    description: descriptor.description,\n    args: cliArgs(descriptor.params),\n    gates: descriptor.gates,\n    run: async args => descriptor.run(operationArgs(descriptor.params, args), {\n      surface: 'cli',\n      // Resolved from the provider flags rather than passed through: which\n      // flags select a backend is the CLI's business, not the operation's.\n      translateFn: descriptor.usesTranslateFn === true\n        ? await resolveProviderTranslateFn(args)\n        : undefined,\n    }),\n    divert: async (result, args) =>\n      divertToReport(result, descriptor, operationArgs(descriptor.params, args)),\n  })\n}\n\n/** The citty `args` for a descriptor's parameters, skipping the CLI-hidden ones. */\nfunction cliArgs(params: Params): Record<string, unknown> {\n  const args: Record<string, unknown> = {}\n  for (const [name, spec] of Object.entries(params)) {\n    if (spec.cli?.hidden === true) continue\n    args[name] = {\n      // citty parses booleans and strings. A list, a number and a JSON object\n      // all arrive as one string and are converted in operationArgs.\n      type: spec.type === 'boolean' ? 'boolean' : 'string',\n      description: flagDescription(spec),\n      ...(spec.required === true ? { required: true } : {}),\n      ...(spec.default === undefined ? {} : { default: spec.default }),\n      ...(spec.cli?.alias === undefined ? {} : { alias: [...toArray(spec.cli.alias)] }),\n      ...(spec.enum === undefined ? {} : { valueHint: spec.enum.join('|') }),\n    }\n  }\n  return args\n}\n\n/**\n * The description a flag prints. The declared one is written for a reader of\n * either surface, so how to spell a list or an object at a shell prompt is\n * added here rather than in every spec.\n */\nfunction flagDescription(spec: ParamSpec): string {\n  if (spec.type === 'string[]') {\n    return `${spec.description} Comma-separated${spec.allowAll === true ? ', or \"all\"' : ''}.`\n  }\n  if (spec.type === 'record') return `${spec.description} Pass it as JSON.`\n  return spec.description\n}\n\n/**\n * citty's parsed args as the operation takes them: lists split, numbers and\n * JSON parsed, enums checked. `projectDir` comes along because every operation\n * accepts it without declaring it.\n */\nfunction operationArgs(params: Params, args: Record<string, unknown>): Record<string, unknown> {\n  const operation: Record<string, unknown> = { projectDir: args.projectDir }\n  for (const [name, spec] of Object.entries(params)) {\n    if (spec.cli?.hidden === true) continue\n    const value = coerce(name, spec, args[name])\n    if (value !== undefined) operation[name] = value\n  }\n  return operation\n}\n\nfunction coerce(name: string, spec: ParamSpec, raw: unknown): unknown {\n  if (spec.type === 'boolean') return typeof raw === 'boolean' ? raw : undefined\n\n  const value = typeof raw === 'string' ? raw : undefined\n\n  switch (spec.type) {\n    case 'number':\n      return value === undefined || value === '' ? undefined : toNumber(name, spec, value)\n    case 'string[]':\n      return toList(name, spec, value)\n    case 'record':\n      return value === undefined ? undefined : parseJsonArg(value, name)\n    default:\n      return toEnumChecked(name, spec, value)\n  }\n}\n\nfunction toEnumChecked(name: string, spec: ParamSpec, value: string | undefined): string | undefined {\n  if (spec.enum === undefined) return value\n  // An empty value is an unset flag, not a value to reject: a shell produces\n  // one routinely from an unset variable.\n  if (value === undefined || value === '') return undefined\n  if (!spec.enum.includes(value)) {\n    throw new Error(`Invalid --${name} value: \"${value}\". Must be one of: ${spec.enum.join(', ')}`)\n  }\n  return value\n}\n\nfunction toNumber(name: string, spec: ParamSpec, raw: string): number {\n  const value = Number(raw)\n  const wellFormed = Number.isFinite(value)\n    && (spec.integer !== true || (Number.isInteger(value) && String(value) === raw.trim()))\n    && (spec.min === undefined || value >= spec.min)\n  if (!wellFormed) {\n    throw new Error(`Invalid --${name}: \"${raw}\". Must be ${numberRequirement(spec)}`)\n  }\n  return value\n}\n\nfunction numberRequirement(spec: ParamSpec): string {\n  if (spec.integer !== true) {\n    return spec.min === undefined ? 'a number' : `a number of at least ${spec.min}`\n  }\n  if (spec.min === 1) return 'a positive integer'\n  return spec.min === undefined ? 'an integer' : `an integer of at least ${spec.min}`\n}\n\nfunction toList(name: string, spec: ParamSpec, raw: string | undefined): string[] | 'all' | undefined {\n  if (spec.allowAll === true && raw === 'all') return 'all'\n\n  const list = splitList(raw)\n  // A list flag that was passed and yielded nothing is a mistake, not a request\n  // for the default — and a required list with nothing in it has no meaning.\n  const empty = list === undefined || list.length === 0\n  if (empty && (spec.required === true || (raw !== undefined && raw !== ''))) {\n    throw new Error(`No ${name} provided. Pass a comma-separated list via --${name}.`)\n  }\n  return list\n}\n\nfunction toArray(value: string | readonly string[]): readonly string[] {\n  return typeof value === 'string' ? [value] : value\n}\n\n/**\n * Build a TranslateFn from the provider flags, or undefined when no provider\n * was given (agent mode). The base URL resolves flag > env > project config;\n * the config file is only read when neither of the first two is set, so a\n * fully-flagged invocation never depends on config discovery.\n */\nexport async function resolveProviderTranslateFn(args: {\n  provider?: string\n  model?: string\n  apiKey?: string\n  baseUrl?: string\n  projectDir?: string\n}): Promise<TranslateFn | undefined> {\n  if (!args.provider) return undefined\n  if (!args.model) {\n    throw new Error('--model is required when --provider is set')\n  }\n\n  let baseUrl = resolveProviderBaseUrl({ flag: args.baseUrl, env: process.env[BASE_URL_ENV] })\n  if (!baseUrl) {\n    const projectConfig = await loadProjectConfig(args.projectDir ?? process.cwd())\n    baseUrl = resolveProviderBaseUrl({ config: projectConfig?.providerBaseUrl })\n  }\n  if (baseUrl) log.debug(`Provider base URL: ${redactBaseUrl(baseUrl)}`)\n\n  return createTranslateFn({\n    provider: args.provider as LlmProvider,\n    model: args.model,\n    apiKey: args.apiKey,\n    baseUrl,\n  })\n}\n\n/**\n * Strip anything secret-shaped from a base URL before it reaches a log.\n * Gateways are routinely addressed as https://user:pass@host or with the key\n * in a query parameter, so keep only origin and path.\n */\nexport function redactBaseUrl(raw: string): string {\n  let url: URL\n  try {\n    url = new URL(raw)\n  } catch {\n    return '<unparseable base URL>'\n  }\n  const credentials = url.username || url.password ? '<redacted>@' : ''\n  const query = url.search || url.hash ? ' (query redacted)' : ''\n  return `${url.protocol}//${credentials}${url.host}${url.pathname}${query}`\n}\n\n/** Split a comma-separated string into a trimmed array, or return undefined */\nfunction splitList(val: string | undefined): string[] | undefined {\n  if (!val) return undefined\n  return val.split(',').map(s => s.trim()).filter(Boolean)\n}\n\n/** Parse a JSON string with a user-friendly error */\nfunction parseJsonArg<T = Record<string, Record<string, string>>>(\n  value: string,\n  argName: string,\n): T {\n  try {\n    return JSON.parse(value) as T\n  } catch (err) {\n    const detail = err instanceof SyntaxError ? err.message : String(err)\n    throw new Error(`Invalid JSON in --${argName}: ${detail}`)\n  }\n}\n","import type { CommandDef } from 'citty'\nimport { commandFromDescriptor } from './_shared.js'\nimport { descriptors } from '../surface/descriptors.js'\n\n/**\n * A registered command: nothing but its lazy loader.\n *\n * There is no way to register a command the CLI does not expose. The flag that\n * allowed it kept producing documented commands that printed \"Unknown command\"\n * when anyone tried them, and every operation an MCP tool covers has to be\n * reachable from a terminal or the two surfaces are not the same tool.\n *\n * The commands themselves are built from the operation descriptors, so the\n * registry states no name, no flag and no description of its own. The loader\n * stays because callers hold it: citty resolves subcommands through it, and the\n * reference generator awaits it. It also keeps the definition's identity\n * stable, which is how the generator recognises two names for one command.\n */\nexport interface CommandEntry {\n  load: () => Promise<CommandDef>\n}\n\nfunction entry(build: () => CommandDef): CommandEntry {\n  let built: CommandDef | undefined\n  return { load: async () => (built ??= build()) }\n}\n\nfunction registry(): Record<string, CommandEntry> {\n  const commands: Record<string, CommandEntry> = {}\n  for (const descriptor of descriptors) {\n    const cli = descriptor.cli\n    if (cli === null) continue\n    commands[cli.name] = entry(() => commandFromDescriptor(descriptor))\n  }\n  return commands\n}\n\nexport const commands: Record<string, CommandEntry> = registry()\n","import { createRequire } from 'node:module'\nimport { defineCommand, runCommand, runMain } from 'citty'\nimport { commands as allCommands } from './commands/index.js'\nimport type { CommandEntry } from './commands/index.js'\nimport { emitErrorResult } from './commands/_shared.js'\n\n// Every registered command is a subcommand. There is no filter here, and no\n// second list to fall out of step with the registry.\nconst commands = Object.fromEntries(\n  Object.entries(allCommands as Record<string, CommandEntry>)\n    .map(([name, entry]) => [name, entry.load]),\n)\n\nconst require = createRequire(import.meta.url)\nconst { version, description } = require('../package.json') as { version: string; description: string }\n\nconst main = defineCommand({\n  meta: {\n    name: 'the-i18n-cli',\n    version,\n    description,\n  },\n  subCommands: commands,\n})\n\nexport async function runCli(): Promise<void> {\n  const rawArgs = process.argv.slice(2)\n\n  // Let citty handle --help and --version natively (pretty-printed usage)\n  if (rawArgs.includes('--help') || rawArgs.includes('-h')\n    || rawArgs.includes('--version') || rawArgs.includes('-v')) {\n    await runMain(main)\n    return\n  }\n\n  // For normal execution, use runCommand so we control error output.\n  // Command run() errors are handled inside createCommand; this catch only\n  // sees pre-run failures (unknown command, argument parsing) — those must\n  // also keep stdout parseable in JSON mode.\n  try {\n    await runCommand(main, { rawArgs })\n  } catch (error: unknown) {\n    emitErrorResult(error, { json: rawArgs.includes('--json') })\n    process.exitCode = 1\n  }\n}\n"],"mappings":"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"}

package/dist/config/framework/stubs/{next-intl-routing-lExp4Q3r.d.ts → next-intl-routing-i6Mlxwdt.d.ts}

@@ -16,4 +16,4 @@
 declare function defineRouting<T>(config: T): T;
 //#endregion
 export { defineRouting as default, defineRouting };
-//# sourceMappingURL=next-intl-routing-lExp4Q3r.d.ts.map
+//# sourceMappingURL=next-intl-routing-i6Mlxwdt.d.ts.map

package/dist/config/framework/stubs/{next-intl-routing-lExp4Q3r.d.ts.map → next-intl-routing-i6Mlxwdt.d.ts.map}

@@ -1 +1 @@
-{"version":3,"file":"next-intl-routing-lExp4Q3r.d.ts","names":[],"sources":["../../../../src/config/framework/stubs/next-intl-routing.ts"],"sourcesContent":[],"mappings":";;AAcA;;;;;;;;;;;;;iBAAgB,yBAAyB,IAAI"}
+{"version":3,"file":"next-intl-routing-i6Mlxwdt.d.ts","names":[],"sources":["../../../../src/config/framework/stubs/next-intl-routing.ts"],"sourcesContent":[],"mappings":";;AAcA;;;;;;;;;;;;;iBAAgB,yBAAyB,IAAI"}

package/dist/{define-config-DW-rgsU6.d.ts → define-config-ChY3jk6K.d.ts}

@@ -1,5 +1,5 @@
 //#region src/adapters/types.d.ts
-type LocaleFileFormat = 'json' | 'php-array';
+type LocaleFileFormat = 'json' | 'php-array' | 'yaml';
 //#endregion
 //#region src/config/types.d.ts
 /**
@@ -35,6 +35,12 @@ interface AppInfo {
   rootDir: string;
   /** Layer names this app consumes (from _layers) */
   layers: string[];
+  /**
+   * Where the consumption edges came from, when it was not the framework
+   * adapter: 'workspace' for package.json dependency inference, 'declared'
+   * for an `apps` list in the project config. Absent means the adapter.
+   */
+  source?: 'workspace' | 'declared';
 }
 /**
  * Project-specific configuration from `.i18n-mcp.json`.
@@ -82,6 +88,13 @@ interface ProjectConfig {
     path: string;
     layer: string;
   }>;
+  /** Declared consumer graph: which app consumes which layers. Overrides both adapter discovery and workspace inference. */
+  apps?: Array<{
+    name: string;
+    layers: string[];
+  }>;
+  /** Whether the consumer graph may be inferred from the workspace when the adapter has no app information ('auto', the default) or not ('off'). */
+  consumerGraph?: 'auto' | 'off';
   /** Default locale code (required for generic adapter activation). */
   defaultLocale?: string;
   /** Explicit list of locale codes. If set, overrides framework auto-detection (all adapters). Auto-discovered when absent. */
@@ -94,13 +107,22 @@ interface ProjectConfig {
    * protection (with a warning).
    */
   protectedLocales?: string[];
-  /** Override the auto-detected locale file format. E.g., "json" or "php-array". Useful when both formats exist or auto-detection picks wrong. */
+  /** Override the auto-detected locale file format. E.g., "json", "php-array" or "yaml". Useful when several formats exist or auto-detection picks wrong. */
   localeFileFormat?: LocaleFileFormat;
+  /**
+   * Write a translation memory to `.i18n-kit.lock.json` at the project root:
+   * per layer, key and target locale, a hash of the source text the translation
+   * was made from. That is what lets a later run tell a current translation from
+   * one whose source has changed since — state alone cannot, because a target
+   * value exists either way. Off by default; no file is created until enabled.
+   */
+  translationMemory?: boolean;
   /**
    * Base URL for the LLM provider — gateways, self-hosted model servers and
    * corporate proxies that speak the provider's own protocol. Overrides the
    * endpoint only, not the request shape or auth header. Overridden by the
-   * I18N_BASE_URL env var and by --baseUrl. Not supported by "google".
+   * I18N_BASE_URL env var and by --baseUrl. Honoured by every provider, each
+   * of which is called over plain HTTP against this base.
    */
   providerBaseUrl?: string;
 }
@@ -146,4 +168,4 @@ type I18nKitConfig = ProjectConfig;
 declare function defineI18nKitConfig(config: I18nKitConfig): I18nKitConfig;
 //#endregion
 export { LocaleDir as a, LocaleDefinition as i, defineI18nKitConfig as n, ProjectConfig as o, I18nConfig as r, LocaleFileFormat as s, I18nKitConfig as t };
-//# sourceMappingURL=define-config-DW-rgsU6.d.ts.map
+//# sourceMappingURL=define-config-ChY3jk6K.d.ts.map

package/dist/define-config-ChY3jk6K.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"define-config-ChY3jk6K.d.ts","names":[],"sources":["../src/adapters/types.ts","../src/config/types.ts","../src/define-config.ts"],"sourcesContent":[],"mappings":";AAEY,KAAA,gBAAA,GAAgB,MAAA,GAAA,WAAA,GAAA,MAAA;;;AAA5B;;;UCGiB,gBAAA;EAAA;EAcA,IAAA,EAAA,MAAS;EAWT;EAmBA,QAAA,EAAA,MAAa;EAAA;MAMf,CAAA,EAAA,MAAA;;MAUC,CAAA,EAAA,MAAA;;;;;AAqBP,UAnEQ,SAAA,CAmER;;EAgB4B,IAAA,EAAA,MAAA;EAsBpB;EAAU,KAAA,EAAA,MAAA;;cAUhB,EAAA,MAAA;;SAMO,CAAA,EAAA,MAAA;;AAIV,UAlHS,OAAA,CAkHT;EAAO;;;;EC5HH;EAQI,MAAA,EAAA,MAAA,EAAA;EAAmB;;;;;;;;;;;UDqBlB,aAAA;;;;;;eAMF;;;;;;aAMF;;;;gBAIG;;;;;;aAMH;;;MAAuC;;eAErC;;;;;;;;;;;eAWA;;;;;SAEN;;;;;;;;;;;;;;;;;;;qBAgBY;;;;;;;;;;;;;;;;;;;;;UAsBJ,UAAA;;;;;;;;kBAQC;;WAEP;;cAEG;;;;kBAII;;qBAEG;;QAEb;;;;;;;;;AA1C6B,KClFzB,aAAA,GAAgB,aDkFS;AAsBrC;;;;;;AAkBqB,iBClHL,mBAAA,CDkHK,MAAA,EClHuB,aDkHvB,CAAA,EClHuC,aDkHvC"}

package/dist/{define-config-BeHvSYBP.d.ts → define-config-e0B0VHq7.d.ts}

@@ -1,2 +1,2 @@
-import { a as LocaleDir, i as LocaleDefinition, n as defineI18nKitConfig, o as ProjectConfig, r as I18nConfig, t as I18nKitConfig } from "./define-config-DW-rgsU6.js";
+import { a as LocaleDir, i as LocaleDefinition, n as defineI18nKitConfig, o as ProjectConfig, r as I18nConfig, t as I18nKitConfig } from "./define-config-ChY3jk6K.js";
 export { I18nConfig, I18nKitConfig, LocaleDefinition, LocaleDir, ProjectConfig, defineI18nKitConfig };

package/dist/define-config.d.ts

@@ -1 +1 @@
-export * from './define-config-BeHvSYBP.d.ts';
+export * from './define-config-e0B0VHq7.d.ts';