Extract custom watch paths to specifications

[isaacroldan]

WHY are these changes introduced?

The current file watching system for dev sessions uses a hardcoded approach where function extensions have custom watch paths while other extensions watch everything. This creates inconsistent behavior and makes it difficult for different extension types to define their own watching requirements.

WHAT is this pull request doing?

Refactors the dev session file watching system to use a specification-based approach:

• Replaces devSessionCustomWatchPaths with a new devSessionWatchConfig method on extension specifications
• Introduces a DevSessionWatchConfig interface that allows extensions to define both paths to watch and patterns to ignore
• Moves function-specific watch logic from the base ExtensionInstance class to the function specification
• Adds watch configuration for admin extensions that only watches the static_root directory when configured
• Sets default behavior where 'configuration' experience extensions watch nothing and 'extension' experience extensions watch everything
• Moves default ignore patterns from the file watcher service to the extension instance level

How to test your changes?

1. Create a function extension with custom build.watch configuration and verify it only watches the specified paths plus default files (locales, GraphQL, TOML)
2. Create an admin extension with static_root configured and verify it only watches files in that directory
3. Create other extension types and verify they follow the default watching behavior based on their experience type
4. Run dev sessions and confirm file changes trigger rebuilds appropriately for each extension type

Checklist

• I've considered possible cross-platform impacts (Mac, Linux, Windows)
• I've considered possible documentation changes
• I've considered analytics changes to measure impact
• The change is user-facing, so I've added a changelog entry with pnpm changeset add

[isaacroldan]

Warning

This pull request is not mergeable via GitHub because a downstack PR is open. Once all requirements are satisfied, merge this PR as a stack on Graphite.
Learn more

• Extract custom watch paths to specifications #7220 : 2 dependent PRs (#7226 , #7227 ) 👈 (View in Graphite)
• Use extension handle to identify extensions in file-watcher #7224
• main

This stack of pull requests is managed by Graphite. Learn more about stacking.

[craigmichaelmartin]

Love these changes! Just a few comments I want to make sure we evaluate!

[craigmichaelmartin]

Looks great!

[github-actions]

Differences in type declarations

We detected differences in the type declarations generated by Typescript for this branch compared to the baseline ('main' branch). Please, review them to ensure they are backward-compatible. Here are some important things to keep in mind:

• Some seemingly private modules might be re-exported through public modules.
• If the branch is behind main you might see odd diffs, rebase main into this branch.

New type declarations

We found no new type declarations in this PR

Existing type declarations

packages/cli-kit/dist/private/node/ui.d.ts

 import { Logger, LogLevel } from '../../public/node/output.js';
-import React from 'react';
 import { Key, RenderOptions } from 'ink';
 import { EventEmitter } from 'events';
-/**
- * Signal that the current Ink tree is done. Must be called within an
- * InkLifecycleRoot — throws if the provider is missing so lifecycle
- * bugs surface immediately instead of silently hanging.
- */
-export declare function useComplete(): (error?: Error) => void;
-/**
- * Root wrapper for Ink trees. Owns the single `exit()` call site — children
- * signal completion via `useComplete()`, which sets state here. The `useEffect`
- * fires post-render, guaranteeing all batched state updates have been flushed
- * before the tree is torn down.
- */
-export declare function InkLifecycleRoot({ children }: {
-    children: React.ReactNode;
-}): React.JSX.Element;
 interface RenderOnceOptions {
     logLevel?: LogLevel;
     logger?: Logger;
     renderOptions?: RenderOptions;
 }
 export declare function renderOnce(element: JSX.Element, { logLevel, renderOptions }: RenderOnceOptions): string | undefined;
-export declare function render(element: JSX.Element, options?: RenderOptions): Promise<void>;
+export declare function render(element: JSX.Element, options?: RenderOptions): Promise<unknown>;
 export declare class Stdout extends EventEmitter {
     columns: number;
     rows: number;
     readonly frames: string[];
     private _lastFrame?;
     constructor(options: {
         columns?: number;
         rows?: number;
     });
     write: (frame: string) => void;
     lastFrame: () => string | undefined;
 }
 export declare function handleCtrlC(input: string, key: Key, exit?: () => void): void;
 export {};

packages/cli-kit/dist/public/node/ui.d.ts

@@ -34,7 +34,7 @@ export interface RenderConcurrentOptions extends PartialBy<ConcurrentOutputProps
  * 00:00:00 │ frontend │ third frontend message
  *
  */
-export declare function renderConcurrent({ renderOptions, ...props }: RenderConcurrentOptions): Promise<void>;
+export declare function renderConcurrent({ renderOptions, ...props }: RenderConcurrentOptions): Promise<unknown>;
 export type AlertCustomSection = CustomSection;
 export type RenderAlertOptions = Omit<AlertOptions, 'type'>;
 /**