@noir-ai/cli 1.3.0-beta.5 → 1.4.0-beta.1

package/dist/bin.d.ts

@@ -1,6 +1,34 @@
 import { Command } from 'commander';
-export { E as EXIT, N as NoirCliError, f as fail, i as inferExitCode } from './output-De3lKbZq.js';
+import { C as CliOptions } from './output-BNE9htEm.js';
+export { E as EXIT, N as NoirCliError, f as fail, i as inferExitCode } from './output-BNE9htEm.js';
 
+/** One entry in the {@link DEPRECATIONS} registry. */
+interface DeprecationEntry {
+    /** Old command form as a path prefix, e.g. `['legacy-status']` or
+     *  `['context','legacy']`. Matched against the dispatched command's path
+     *  (program name `noir` stripped). */
+    readonly oldArgv: readonly string[];
+    /** Replacement command form, e.g. `['status']`. Shown in the redirect hint. */
+    readonly newArgv: readonly string[];
+    /** Version the deprecation started in, e.g. `'1.4.0'`. */
+    readonly since: string;
+}
+/**
+ * Deprecation registry. **Empty today** — no `noir` command is deprecated.
+ * When adding an entry, also update `docs/deprecation.md` (and, if the old
+ * form still routes, add a redirect). {@link emitDeprecationHintsFor} scans
+ * this on every dispatch and emits one `tip()` per match; `--no-tips` /
+ * `--json` suppress the hint (see {@link tip}).
+ */
+declare const DEPRECATIONS: DeprecationEntry[];
+/**
+ * Emit one redirect hint per matching {@link DEPRECATIONS} entry for the
+ * dispatched command. Respects `--no-tips` and `--json` via {@link tip} (a CI
+ * run's stderr stays quiet and its stdout envelope stays pristine). Exported so
+ * tests can drive it with a temporarily-populated registry without going
+ * through commander.
+ */
+declare function emitDeprecationHintsFor(cmd: Command, opts: CliOptions): void;
 declare function createProgram(): Command;
 /** Singleton program used by the bin entry (`run`) and re-exported for convenience. */
 declare const program: Command;
@@ -11,4 +39,4 @@ declare const program: Command;
  */
 declare function run(argv?: readonly string[]): Promise<number>;
 
-export { createProgram, program, run };
+export { DEPRECATIONS, type DeprecationEntry, createProgram, emitDeprecationHintsFor, program, run };