@noir-ai/create 1.19.0 → 1.19.1

package/dist/index.d.ts

@@ -14,6 +14,37 @@ declare function readAncestors(root: string): Record<string, string>;
  *  leaves ancestors.json untouched (no mtime/git churn). */
 declare function writeAncestors(root: string, map: Record<string, string>): void;
 
+/**
+ * Emit a host's lifecycle-hook config on demand — the write-once `mergeJson`
+ * hook the scaffold deliberately does NOT re-emit on `noir init --upgrade` or
+ * `noir sync`. This is the explicit restore path (`noir hooks sync`): it runs
+ * the same `adapter.emitHooks` seam the scaffold uses and dispatches each entry
+ * to the writer its mode names (`regenerate` for cursor, `mergeJson` for
+ * claude/gemini). With `force`, an existing Noir-owned hook entry (one whose
+ * command carries the dedup marker) is refreshed to the currently resolved
+ * command instead of being left as-is; the user's other keys and non-Noir hooks
+ * are never touched.
+ *
+ * Pure filesystem work — no daemon, no store, no prompt. A host with no hook
+ * surface (agents-md, opencode) returns an empty outcome list.
+ */
+/** One host hook-config write performed by {@link emitHooksToFile}. */
+interface HookEmitOutcome {
+    /** Repo-relative path of the host's hook config file. */
+    path: string;
+    /** `mergeJson` = merged into a user-owned file; `regenerate` = rewritten. */
+    mode: 'mergeJson' | 'regenerate';
+    /** True when the bytes on disk changed (a write happened). */
+    written: boolean;
+}
+interface EmitHooksResult {
+    host: HostId;
+    outcomes: HookEmitOutcome[];
+}
+declare function emitHooksToFile(root: string, host: HostId, opts?: {
+    force?: boolean;
+}): EmitHooksResult;
+
 /**
  * READ-ONLY stack detection. Probes for well-known marker files under `root`
  * and reports ONLY what is present — never assumes. The result feeds path
@@ -939,4 +970,4 @@ declare function loadTemplate(name: string): string;
 /** Resolve a template name to its absolute path (for diagnostics + tests). */
 declare function templatesDir(): string;
 
-export { BRIEF_BLOCK, type BuildHostArtifactsContext, type BuildManifestContext, CURRENT_SCAFFOLD_VERSION, type ConflictContext, type ConflictRecord, type ConflictResolution, type ConflictResolverReturn, type DiffLine, type EnvMode, type HostTag, MANIFEST_PATH_PARITY, MIGRATIONS, type ManifestEntry, type MergeResult, type MigrationContext, type MigrationResult, type MigrationScript, SEED_TEMPLATE_HISTORY, type ScaffoldMode, type ScaffoldOptions, type ScaffoldResult, type SeedTemplateHistoryEntry, type StackInfo, type WriteMode, type WriteOutcome, ancestorsPath, applyInlineConflict, applyWithConflict, assertSafeRoot, buildHostArtifacts, buildManifest, buildRegion, detectStack, isStaleSeed, lineDiff, loadTemplate, managedBlock, mergeThreeWay, readAncestors, readScaffoldVersion, regenerate, render, runMigrations, scaffold, scaffoldVersionPath, skipIfExists, templatesDir, writeAncestors, writeScaffoldVersion, zdiff3Region };
+export { BRIEF_BLOCK, type BuildHostArtifactsContext, type BuildManifestContext, CURRENT_SCAFFOLD_VERSION, type ConflictContext, type ConflictRecord, type ConflictResolution, type ConflictResolverReturn, type DiffLine, type EmitHooksResult, type EnvMode, type HookEmitOutcome, type HostTag, MANIFEST_PATH_PARITY, MIGRATIONS, type ManifestEntry, type MergeResult, type MigrationContext, type MigrationResult, type MigrationScript, SEED_TEMPLATE_HISTORY, type ScaffoldMode, type ScaffoldOptions, type ScaffoldResult, type SeedTemplateHistoryEntry, type StackInfo, type WriteMode, type WriteOutcome, ancestorsPath, applyInlineConflict, applyWithConflict, assertSafeRoot, buildHostArtifacts, buildManifest, buildRegion, detectStack, emitHooksToFile, isStaleSeed, lineDiff, loadTemplate, managedBlock, mergeThreeWay, readAncestors, readScaffoldVersion, regenerate, render, runMigrations, scaffold, scaffoldVersionPath, skipIfExists, templatesDir, writeAncestors, writeScaffoldVersion, zdiff3Region };