@noir-ai/cli 1.14.0 → 1.15.0

package/dist/index.d.ts

@@ -1,6 +1,7 @@
-import { C as CliOptions } from './output-BNE9htEm.js';
+import { C as CliOptions } from './output-2T2lGR7a.js';
 import { HostId } from '@noir-ai/adapters';
 import { ScaffoldResult } from '@noir-ai/create';
+import { SkillConflict } from '@noir-ai/skills';
 
 /** Options accepted by `doctor`: the global flags + the opt-in `--dedup`. */
 interface DoctorOptions extends CliOptions {
@@ -26,28 +27,54 @@ interface InitOptions {
      *  absent. That backfills seeds added to the manifest after this project was
      *  initialized without ever touching a user-owned file. */
     upgrade?: boolean;
-    /** S10 target host. Defaults to `'claude'` (the regression anchor). Drives
-     *  both scaffold emission (the manifest's host-specific half) and skills
-     *  emission (skipped for hosts with no `skillsDir`). */
+    /** Target host. Resolution order: this explicit `--host <id>` value > the
+     *  `host:` field of an existing `.noir/config.yml` > `'claude'` (the default,
+     *  and the regression anchor for a project that has no config yet). Reading
+     *  the configured host matters for `--upgrade`/`--force`, which re-emit into
+     *  a project that already chose a host: emitting under the default instead
+     *  would write a spurious claude surface and refresh none of the artifacts
+     *  the project actually uses. An absent or unreadable config degrades to the
+     *  default rather than failing the run.
+     *  Drives both scaffold emission (the manifest's host-specific half) and
+     *  skills emission (skipped for hosts with no `skillsDir`). */
     host?: HostId;
-    /** SP-A: re-scaffold even if already initialized (bypasses the
+    /** Re-scaffold even if already initialized (bypasses the
      *  already-initialized no-op guard in scaffold()). */
     force?: boolean;
-    /** F1: `--dry-run`/`--preview` — report the planned writes to stderr
+    /** `--dry-run`/`--preview` — report the planned writes to stderr
      *  (via {@link reportPlannedWrites}) without touching disk. The scaffold
      *  engine already supports this; the CLI just surfaces it. */
     dryRun?: boolean;
-    /** F1: alias for `--dry-run`. Kept on the options bag so direct callers can
+    /** Alias for `--dry-run`. Kept on the options bag so direct callers can
      *  pass either spelling; the bin collapses both flags before dispatch. */
     preview?: boolean;
 }
 /**
- * Initialize Noir in `root`. Returns the {@link ScaffoldResult} (with
- * structured `conflicts[]` + any dedup records appended) so `--json`
- * callers can surface conflict detail. `undefined` when the already-initialized
- * guard short-circuited (a no-op).
+ * The {@link ScaffoldResult} plus the skill pack's own report. The scaffold's
+ * `conflicts[]` covers the files the manifest owns; skills are emitted outside
+ * the manifest, so their conflicts and their stale leftovers would otherwise
+ * be invisible to a `--json` consumer.
  */
-declare function init(root: string, opts: InitOptions): Promise<ScaffoldResult | undefined>;
+interface InitResult extends ScaffoldResult {
+    /** One record per skill file that existed AND differed from the compiled
+     *  bytes, with the resolution that was applied — including the files a
+     *  non-interactive run left alone. Always an array once skills emission has
+     *  run; absent on the `--dry-run` and already-initialized paths, which stop
+     *  before emission. */
+    skillConflicts?: SkillConflict[];
+    /** Names of the skills left with the user's own bytes because a differing
+     *  file was preserved. Empty when every skill is current — the `--json`
+     *  counterpart of the stderr line that warns about stale skills. */
+    preservedSkills?: string[];
+}
+/**
+ * Initialize Noir in `root`. Returns the {@link InitResult} (the
+ * {@link ScaffoldResult} with structured `conflicts[]`, any dedup records, and
+ * the skill pack's conflicts/stale names) so `--json` callers can surface
+ * conflict detail. `undefined` when the already-initialized guard
+ * short-circuited (a no-op).
+ */
+declare function init(root: string, opts: InitOptions): Promise<InitResult | undefined>;
 
 declare function serve(opts: {
     stdio: boolean;