@ai-agent-forge/agent-forge 0.85.0

package/dist/core/facade/coding-agent-runtime-facade.d.ts

@@ -0,0 +1,115 @@
+/**
+ * Stable runtime facade v1 (阶段 4 slice 3): a versioned surface over
+ * AgentSessionRuntime for host session lifecycle orchestration and the static
+ * session selector reads.
+ *
+ * Design: docs/design/稳定门面统一入口设计.md (§3.5 阶段 4 slice 3 runtime 面,
+ * D-041). This is an independent versioned contract alongside the frozen
+ * `CodingAgentFacadeV1` session face (§3.1): the v1 session face is unchanged,
+ * and lifecycle orchestration never belonged on a per-session facade because
+ * the runtime owns teardown/rebind ordering across session replacement
+ * (session_shutdown → beforeSessionInvalidate → dispose → create → rebind).
+ * Every member is a pure delegate onto the wrapped AgentSessionRuntime or the
+ * current session's SessionManager (instance reads / static selectors). No new
+ * behavior, no policy, no state of its own. SessionManager does leak at two
+ * controlled points: the `newSession` `setup` callback receives the new
+ * session's `SessionManager` for assembly-time writes — hosts and extensions
+ * seed session content (e.g. `appendMessage`) before the runtime applies the
+ * built context; deprecated on the extension surface in favor of the
+ * CapabilityAPI session surface — and the `setRebindSession` callback receives
+ * the internal `AgentSession` instance so hosts can rebind their session
+ * references after replacement.
+ *
+ * D-063 adds the one projection member, `getSessionFacade()`: the v1 session face
+ * over the runtime's current session, re-derived per call, so a stable consumer
+ * that only needs the active session's facade never touches the raw
+ * `AgentSession` and never re-constructs anything after a replacement.
+ */
+import type { AgentSession } from "../agent-session.ts";
+import type { AgentSessionRuntime, ReplacedSessionContext } from "../agent-session-runtime.ts";
+import type { SessionInfo, SessionListProgress } from "../session-manager.ts";
+import { SessionManager } from "../session-manager.ts";
+import { type CodingAgentFacadeV1 } from "./coding-agent-facade.ts";
+/**
+ * Stable runtime facade v1: the consumption surface for host lifecycle
+ * orchestration, versioned per repo convention (CodingAgentFacadeV1
+ * precedent). New members must extend the facade design doc first (门面腐化
+ * guard, 设计 §6).
+ */
+export interface CodingAgentRuntimeFacadeV1 {
+    readonly version: 1;
+    /** Delegates to AgentSessionRuntime.newSession(). */
+    newSession(options?: {
+        parentSession?: string;
+        setup?: (sessionManager: SessionManager) => Promise<void>;
+        withSession?: (ctx: ReplacedSessionContext) => Promise<void>;
+    }): Promise<{
+        cancelled: boolean;
+    }>;
+    /** Delegates to AgentSessionRuntime.fork(). */
+    fork(entryId: string, options?: {
+        position?: "before" | "at";
+        withSession?: (ctx: ReplacedSessionContext) => Promise<void>;
+    }): Promise<{
+        cancelled: boolean;
+        selectedText?: string;
+    }>;
+    /** Delegates to AgentSessionRuntime.switchSession(). */
+    switchSession(sessionPath: string, options?: {
+        cwdOverride?: string;
+        withSession?: (ctx: ReplacedSessionContext) => Promise<void>;
+    }): Promise<{
+        cancelled: boolean;
+    }>;
+    /** Delegates to AgentSessionRuntime.importFromJsonl(). */
+    importFromJsonl(inputPath: string, cwdOverride?: string): Promise<{
+        cancelled: boolean;
+    }>;
+    /** Delegates to AgentSessionRuntime.dispose(). */
+    dispose(): Promise<void>;
+    /** Delegates to AgentSessionRuntime.setBeforeSessionInvalidate(). */
+    setBeforeSessionInvalidate(beforeSessionInvalidate?: () => void): void;
+    /** Delegates to AgentSessionRuntime.setRebindSession(). */
+    setRebindSession(rebindSession?: (session: AgentSession) => Promise<void>): void;
+    /**
+     * The v1 session facade over the runtime's **current** session
+     * (`createCodingAgentFacade(runtime.session)`), re-derived on every call.
+     *
+     * Replacements (newSession/switchSession/fork/importFromJsonl) invalidate the
+     * previous session, so a facade held across one of them would keep reading a
+     * dead session — call this accessor again after a replacement instead of
+     * caching it. Complement to `setRebindSession`: that hook keeps host-held
+     * *internal* session references fresh (extension binding, host state), while
+     * this member is the stable-surface way to reach the current session without
+     * the raw `AgentSession` ever leaving the adapter (D-063).
+     */
+    getSessionFacade(): CodingAgentFacadeV1;
+    /**
+     * Delegates to SessionManager.list(cwd, sessionDir) on the current session's
+     * manager: sessions of the current cwd/session dir, newest first.
+     */
+    listSessions(onProgress?: SessionListProgress): Promise<SessionInfo[]>;
+    /**
+     * Delegates to SessionManager.listAll() on the current session's manager:
+     * the default session dir when the session uses it, the session's own dir
+     * otherwise (same branch as the interactive selector).
+     */
+    listAllSessions(onProgress?: SessionListProgress): Promise<SessionInfo[]>;
+    /** Delegates to SessionManager.getSessionFile() on the current session's manager. */
+    getSessionFile(): string | undefined;
+    /** Delegates to SessionManager.getSessionDir() on the current session's manager. */
+    getSessionDir(): string;
+    /** Delegates to SessionManager.usesDefaultSessionDir() on the current session's manager. */
+    usesDefaultSessionDir(): boolean;
+    /** Delegates to SessionManager.isPersisted() on the current session's manager. */
+    isPersisted(): boolean;
+    /** Delegates to SessionManager.getSessionId() on the current session's manager. */
+    getSessionId(): string;
+}
+/**
+ * Creates a runtime facade v1 view over one AgentSessionRuntime. Pure wrapper:
+ * holds no state of its own. Derive on each access (or after a rebind) so the
+ * wrapper always reads the runtime's current session.
+ */
+export declare function createCodingAgentRuntimeFacade(runtime: AgentSessionRuntime): CodingAgentRuntimeFacadeV1;
+//# sourceMappingURL=coding-agent-runtime-facade.d.ts.map

package/dist/core/facade/coding-agent-runtime-facade.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"coding-agent-runtime-facade.d.ts","sourceRoot":"","sources":["../../../src/core/facade/coding-agent-runtime-facade.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Stable runtime facade v1 (阶段 4 slice 3): a versioned surface over\n * AgentSessionRuntime for host session lifecycle orchestration and the static\n * session selector reads.\n *\n * Design: docs/design/稳定门面统一入口设计.md (§3.5 阶段 4 slice 3 runtime 面,\n * D-041). This is an independent versioned contract alongside the frozen\n * `CodingAgentFacadeV1` session face (§3.1): the v1 session face is unchanged,\n * and lifecycle orchestration never belonged on a per-session facade because\n * the runtime owns teardown/rebind ordering across session replacement\n * (session_shutdown → beforeSessionInvalidate → dispose → create → rebind).\n * Every member is a pure delegate onto the wrapped AgentSessionRuntime or the\n * current session's SessionManager (instance reads / static selectors). No new\n * behavior, no policy, no state of its own. SessionManager does leak at two\n * controlled points: the `newSession` `setup` callback receives the new\n * session's `SessionManager` for assembly-time writes — hosts and extensions\n * seed session content (e.g. `appendMessage`) before the runtime applies the\n * built context; deprecated on the extension surface in favor of the\n * CapabilityAPI session surface — and the `setRebindSession` callback receives\n * the internal `AgentSession` instance so hosts can rebind their session\n * references after replacement.\n *\n * D-063 adds the one projection member, `getSessionFacade()`: the v1 session face\n * over the runtime's current session, re-derived per call, so a stable consumer\n * that only needs the active session's facade never touches the raw\n * `AgentSession` and never re-constructs anything after a replacement.\n */\n\nimport type { AgentSession } from \"../agent-session.ts\";\nimport type { AgentSessionRuntime, ReplacedSessionContext } from \"../agent-session-runtime.ts\";\nimport type { SessionInfo, SessionListProgress } from \"../session-manager.ts\";\nimport { SessionManager } from \"../session-manager.ts\";\nimport { type CodingAgentFacadeV1, createCodingAgentFacade } from \"./coding-agent-facade.ts\";\n\n/**\n * Stable runtime facade v1: the consumption surface for host lifecycle\n * orchestration, versioned per repo convention (CodingAgentFacadeV1\n * precedent). New members must extend the facade design doc first (门面腐化\n * guard, 设计 §6).\n */\nexport interface CodingAgentRuntimeFacadeV1 {\n\treadonly version: 1;\n\n\t// --- Lifecycle orchestration (delegates to AgentSessionRuntime verbatim) ---\n\t/** Delegates to AgentSessionRuntime.newSession(). */\n\tnewSession(options?: {\n\t\tparentSession?: string;\n\t\tsetup?: (sessionManager: SessionManager) => Promise<void>;\n\t\twithSession?: (ctx: ReplacedSessionContext) => Promise<void>;\n\t}): Promise<{ cancelled: boolean }>;\n\t/** Delegates to AgentSessionRuntime.fork(). */\n\tfork(\n\t\tentryId: string,\n\t\toptions?: { position?: \"before\" | \"at\"; withSession?: (ctx: ReplacedSessionContext) => Promise<void> },\n\t): Promise<{ cancelled: boolean; selectedText?: string }>;\n\t/** Delegates to AgentSessionRuntime.switchSession(). */\n\tswitchSession(\n\t\tsessionPath: string,\n\t\toptions?: { cwdOverride?: string; withSession?: (ctx: ReplacedSessionContext) => Promise<void> },\n\t): Promise<{ cancelled: boolean }>;\n\t/** Delegates to AgentSessionRuntime.importFromJsonl(). */\n\timportFromJsonl(inputPath: string, cwdOverride?: string): Promise<{ cancelled: boolean }>;\n\t/** Delegates to AgentSessionRuntime.dispose(). */\n\tdispose(): Promise<void>;\n\t/** Delegates to AgentSessionRuntime.setBeforeSessionInvalidate(). */\n\tsetBeforeSessionInvalidate(beforeSessionInvalidate?: () => void): void;\n\t/** Delegates to AgentSessionRuntime.setRebindSession(). */\n\tsetRebindSession(rebindSession?: (session: AgentSession) => Promise<void>): void;\n\n\t// --- Current-session projection (bridge to the v1 session face) ---\n\t/**\n\t * The v1 session facade over the runtime's **current** session\n\t * (`createCodingAgentFacade(runtime.session)`), re-derived on every call.\n\t *\n\t * Replacements (newSession/switchSession/fork/importFromJsonl) invalidate the\n\t * previous session, so a facade held across one of them would keep reading a\n\t * dead session — call this accessor again after a replacement instead of\n\t * caching it. Complement to `setRebindSession`: that hook keeps host-held\n\t * *internal* session references fresh (extension binding, host state), while\n\t * this member is the stable-surface way to reach the current session without\n\t * the raw `AgentSession` ever leaving the adapter (D-063).\n\t */\n\tgetSessionFacade(): CodingAgentFacadeV1;\n\n\t// --- Session selector reads (SessionManager statics + instance reads) ---\n\t/**\n\t * Delegates to SessionManager.list(cwd, sessionDir) on the current session's\n\t * manager: sessions of the current cwd/session dir, newest first.\n\t */\n\tlistSessions(onProgress?: SessionListProgress): Promise<SessionInfo[]>;\n\t/**\n\t * Delegates to SessionManager.listAll() on the current session's manager:\n\t * the default session dir when the session uses it, the session's own dir\n\t * otherwise (same branch as the interactive selector).\n\t */\n\tlistAllSessions(onProgress?: SessionListProgress): Promise<SessionInfo[]>;\n\t/** Delegates to SessionManager.getSessionFile() on the current session's manager. */\n\tgetSessionFile(): string | undefined;\n\t/** Delegates to SessionManager.getSessionDir() on the current session's manager. */\n\tgetSessionDir(): string;\n\t/** Delegates to SessionManager.usesDefaultSessionDir() on the current session's manager. */\n\tusesDefaultSessionDir(): boolean;\n\t/** Delegates to SessionManager.isPersisted() on the current session's manager. */\n\tisPersisted(): boolean;\n\t/** Delegates to SessionManager.getSessionId() on the current session's manager. */\n\tgetSessionId(): string;\n}\n\n/**\n * Creates a runtime facade v1 view over one AgentSessionRuntime. Pure wrapper:\n * holds no state of its own. Derive on each access (or after a rebind) so the\n * wrapper always reads the runtime's current session.\n */\nexport function createCodingAgentRuntimeFacade(runtime: AgentSessionRuntime): CodingAgentRuntimeFacadeV1 {\n\tconst sessionManager = () => runtime.session.sessionManager;\n\treturn {\n\t\tversion: 1,\n\t\t// Rest-args forwarding keeps the delegation call-arity identical to a\n\t\t// direct runtime call (optional options are not materialized as\n\t\t// explicit undefined arguments).\n\t\tnewSession: (...args) => runtime.newSession(...args),\n\t\tfork: (...args) => runtime.fork(...args),\n\t\tswitchSession: (...args) => runtime.switchSession(...args),\n\t\timportFromJsonl: (...args) => runtime.importFromJsonl(...args),\n\t\tdispose: () => runtime.dispose(),\n\t\tsetBeforeSessionInvalidate: (beforeSessionInvalidate) =>\n\t\t\truntime.setBeforeSessionInvalidate(beforeSessionInvalidate),\n\t\tsetRebindSession: (rebindSession) => runtime.setRebindSession(rebindSession),\n\t\t// Re-projected per call so the accessor follows the runtime's current session\n\t\t// across replacements (the v1 session facade holds no state of its own).\n\t\tgetSessionFacade: () => createCodingAgentFacade(runtime.session),\n\t\tlistSessions: (onProgress) =>\n\t\t\tSessionManager.list(sessionManager().getCwd(), sessionManager().getSessionDir(), onProgress),\n\t\tlistAllSessions: (onProgress) =>\n\t\t\tsessionManager().usesDefaultSessionDir()\n\t\t\t\t? SessionManager.listAll(onProgress)\n\t\t\t\t: SessionManager.listAll(sessionManager().getSessionDir(), onProgress),\n\t\tgetSessionFile: () => sessionManager().getSessionFile(),\n\t\tgetSessionDir: () => sessionManager().getSessionDir(),\n\t\tusesDefaultSessionDir: () => sessionManager().usesDefaultSessionDir(),\n\t\tisPersisted: () => sessionManager().isPersisted(),\n\t\tgetSessionId: () => sessionManager().getSessionId(),\n\t};\n}\n"]}

package/dist/core/facade/coding-agent-runtime-facade.js

@@ -0,0 +1,63 @@
+/**
+ * Stable runtime facade v1 (阶段 4 slice 3): a versioned surface over
+ * AgentSessionRuntime for host session lifecycle orchestration and the static
+ * session selector reads.
+ *
+ * Design: docs/design/稳定门面统一入口设计.md (§3.5 阶段 4 slice 3 runtime 面,
+ * D-041). This is an independent versioned contract alongside the frozen
+ * `CodingAgentFacadeV1` session face (§3.1): the v1 session face is unchanged,
+ * and lifecycle orchestration never belonged on a per-session facade because
+ * the runtime owns teardown/rebind ordering across session replacement
+ * (session_shutdown → beforeSessionInvalidate → dispose → create → rebind).
+ * Every member is a pure delegate onto the wrapped AgentSessionRuntime or the
+ * current session's SessionManager (instance reads / static selectors). No new
+ * behavior, no policy, no state of its own. SessionManager does leak at two
+ * controlled points: the `newSession` `setup` callback receives the new
+ * session's `SessionManager` for assembly-time writes — hosts and extensions
+ * seed session content (e.g. `appendMessage`) before the runtime applies the
+ * built context; deprecated on the extension surface in favor of the
+ * CapabilityAPI session surface — and the `setRebindSession` callback receives
+ * the internal `AgentSession` instance so hosts can rebind their session
+ * references after replacement.
+ *
+ * D-063 adds the one projection member, `getSessionFacade()`: the v1 session face
+ * over the runtime's current session, re-derived per call, so a stable consumer
+ * that only needs the active session's facade never touches the raw
+ * `AgentSession` and never re-constructs anything after a replacement.
+ */
+import { SessionManager } from "../session-manager.js";
+import { createCodingAgentFacade } from "./coding-agent-facade.js";
+/**
+ * Creates a runtime facade v1 view over one AgentSessionRuntime. Pure wrapper:
+ * holds no state of its own. Derive on each access (or after a rebind) so the
+ * wrapper always reads the runtime's current session.
+ */
+export function createCodingAgentRuntimeFacade(runtime) {
+    const sessionManager = () => runtime.session.sessionManager;
+    return {
+        version: 1,
+        // Rest-args forwarding keeps the delegation call-arity identical to a
+        // direct runtime call (optional options are not materialized as
+        // explicit undefined arguments).
+        newSession: (...args) => runtime.newSession(...args),
+        fork: (...args) => runtime.fork(...args),
+        switchSession: (...args) => runtime.switchSession(...args),
+        importFromJsonl: (...args) => runtime.importFromJsonl(...args),
+        dispose: () => runtime.dispose(),
+        setBeforeSessionInvalidate: (beforeSessionInvalidate) => runtime.setBeforeSessionInvalidate(beforeSessionInvalidate),
+        setRebindSession: (rebindSession) => runtime.setRebindSession(rebindSession),
+        // Re-projected per call so the accessor follows the runtime's current session
+        // across replacements (the v1 session facade holds no state of its own).
+        getSessionFacade: () => createCodingAgentFacade(runtime.session),
+        listSessions: (onProgress) => SessionManager.list(sessionManager().getCwd(), sessionManager().getSessionDir(), onProgress),
+        listAllSessions: (onProgress) => sessionManager().usesDefaultSessionDir()
+            ? SessionManager.listAll(onProgress)
+            : SessionManager.listAll(sessionManager().getSessionDir(), onProgress),
+        getSessionFile: () => sessionManager().getSessionFile(),
+        getSessionDir: () => sessionManager().getSessionDir(),
+        usesDefaultSessionDir: () => sessionManager().usesDefaultSessionDir(),
+        isPersisted: () => sessionManager().isPersisted(),
+        getSessionId: () => sessionManager().getSessionId(),
+    };
+}
+//# sourceMappingURL=coding-agent-runtime-facade.js.map

package/dist/core/facade/coding-agent-runtime-facade.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"coding-agent-runtime-facade.js","sourceRoot":"","sources":["../../../src/core/facade/coding-agent-runtime-facade.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAKH,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAA4B,uBAAuB,EAAE,MAAM,0BAA0B,CAAC;AA4E7F;;;;GAIG;AACH,MAAM,UAAU,8BAA8B,CAAC,OAA4B,EAA8B;IACxG,MAAM,cAAc,GAAG,GAAG,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,cAAc,CAAC;IAC5D,OAAO;QACN,OAAO,EAAE,CAAC;QACV,sEAAsE;QACtE,gEAAgE;QAChE,iCAAiC;QACjC,UAAU,EAAE,CAAC,GAAG,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,UAAU,CAAC,GAAG,IAAI,CAAC;QACpD,IAAI,EAAE,CAAC,GAAG,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;QACxC,aAAa,EAAE,CAAC,GAAG,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,aAAa,CAAC,GAAG,IAAI,CAAC;QAC1D,eAAe,EAAE,CAAC,GAAG,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,eAAe,CAAC,GAAG,IAAI,CAAC;QAC9D,OAAO,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,OAAO,EAAE;QAChC,0BAA0B,EAAE,CAAC,uBAAuB,EAAE,EAAE,CACvD,OAAO,CAAC,0BAA0B,CAAC,uBAAuB,CAAC;QAC5D,gBAAgB,EAAE,CAAC,aAAa,EAAE,EAAE,CAAC,OAAO,CAAC,gBAAgB,CAAC,aAAa,CAAC;QAC5E,8EAA8E;QAC9E,yEAAyE;QACzE,gBAAgB,EAAE,GAAG,EAAE,CAAC,uBAAuB,CAAC,OAAO,CAAC,OAAO,CAAC;QAChE,YAAY,EAAE,CAAC,UAAU,EAAE,EAAE,CAC5B,cAAc,CAAC,IAAI,CAAC,cAAc,EAAE,CAAC,MAAM,EAAE,EAAE,cAAc,EAAE,CAAC,aAAa,EAAE,EAAE,UAAU,CAAC;QAC7F,eAAe,EAAE,CAAC,UAAU,EAAE,EAAE,CAC/B,cAAc,EAAE,CAAC,qBAAqB,EAAE;YACvC,CAAC,CAAC,cAAc,CAAC,OAAO,CAAC,UAAU,CAAC;YACpC,CAAC,CAAC,cAAc,CAAC,OAAO,CAAC,cAAc,EAAE,CAAC,aAAa,EAAE,EAAE,UAAU,CAAC;QACxE,cAAc,EAAE,GAAG,EAAE,CAAC,cAAc,EAAE,CAAC,cAAc,EAAE;QACvD,aAAa,EAAE,GAAG,EAAE,CAAC,cAAc,EAAE,CAAC,aAAa,EAAE;QACrD,qBAAqB,EAAE,GAAG,EAAE,CAAC,cAAc,EAAE,CAAC,qBAAqB,EAAE;QACrE,WAAW,EAAE,GAAG,EAAE,CAAC,cAAc,EAAE,CAAC,WAAW,EAAE;QACjD,YAAY,EAAE,GAAG,EAAE,CAAC,cAAc,EAAE,CAAC,YAAY,EAAE;KACnD,CAAC;AAAA,CACF","sourcesContent":["/**\n * Stable runtime facade v1 (阶段 4 slice 3): a versioned surface over\n * AgentSessionRuntime for host session lifecycle orchestration and the static\n * session selector reads.\n *\n * Design: docs/design/稳定门面统一入口设计.md (§3.5 阶段 4 slice 3 runtime 面,\n * D-041). This is an independent versioned contract alongside the frozen\n * `CodingAgentFacadeV1` session face (§3.1): the v1 session face is unchanged,\n * and lifecycle orchestration never belonged on a per-session facade because\n * the runtime owns teardown/rebind ordering across session replacement\n * (session_shutdown → beforeSessionInvalidate → dispose → create → rebind).\n * Every member is a pure delegate onto the wrapped AgentSessionRuntime or the\n * current session's SessionManager (instance reads / static selectors). No new\n * behavior, no policy, no state of its own. SessionManager does leak at two\n * controlled points: the `newSession` `setup` callback receives the new\n * session's `SessionManager` for assembly-time writes — hosts and extensions\n * seed session content (e.g. `appendMessage`) before the runtime applies the\n * built context; deprecated on the extension surface in favor of the\n * CapabilityAPI session surface — and the `setRebindSession` callback receives\n * the internal `AgentSession` instance so hosts can rebind their session\n * references after replacement.\n *\n * D-063 adds the one projection member, `getSessionFacade()`: the v1 session face\n * over the runtime's current session, re-derived per call, so a stable consumer\n * that only needs the active session's facade never touches the raw\n * `AgentSession` and never re-constructs anything after a replacement.\n */\n\nimport type { AgentSession } from \"../agent-session.ts\";\nimport type { AgentSessionRuntime, ReplacedSessionContext } from \"../agent-session-runtime.ts\";\nimport type { SessionInfo, SessionListProgress } from \"../session-manager.ts\";\nimport { SessionManager } from \"../session-manager.ts\";\nimport { type CodingAgentFacadeV1, createCodingAgentFacade } from \"./coding-agent-facade.ts\";\n\n/**\n * Stable runtime facade v1: the consumption surface for host lifecycle\n * orchestration, versioned per repo convention (CodingAgentFacadeV1\n * precedent). New members must extend the facade design doc first (门面腐化\n * guard, 设计 §6).\n */\nexport interface CodingAgentRuntimeFacadeV1 {\n\treadonly version: 1;\n\n\t// --- Lifecycle orchestration (delegates to AgentSessionRuntime verbatim) ---\n\t/** Delegates to AgentSessionRuntime.newSession(). */\n\tnewSession(options?: {\n\t\tparentSession?: string;\n\t\tsetup?: (sessionManager: SessionManager) => Promise<void>;\n\t\twithSession?: (ctx: ReplacedSessionContext) => Promise<void>;\n\t}): Promise<{ cancelled: boolean }>;\n\t/** Delegates to AgentSessionRuntime.fork(). */\n\tfork(\n\t\tentryId: string,\n\t\toptions?: { position?: \"before\" | \"at\"; withSession?: (ctx: ReplacedSessionContext) => Promise<void> },\n\t): Promise<{ cancelled: boolean; selectedText?: string }>;\n\t/** Delegates to AgentSessionRuntime.switchSession(). */\n\tswitchSession(\n\t\tsessionPath: string,\n\t\toptions?: { cwdOverride?: string; withSession?: (ctx: ReplacedSessionContext) => Promise<void> },\n\t): Promise<{ cancelled: boolean }>;\n\t/** Delegates to AgentSessionRuntime.importFromJsonl(). */\n\timportFromJsonl(inputPath: string, cwdOverride?: string): Promise<{ cancelled: boolean }>;\n\t/** Delegates to AgentSessionRuntime.dispose(). */\n\tdispose(): Promise<void>;\n\t/** Delegates to AgentSessionRuntime.setBeforeSessionInvalidate(). */\n\tsetBeforeSessionInvalidate(beforeSessionInvalidate?: () => void): void;\n\t/** Delegates to AgentSessionRuntime.setRebindSession(). */\n\tsetRebindSession(rebindSession?: (session: AgentSession) => Promise<void>): void;\n\n\t// --- Current-session projection (bridge to the v1 session face) ---\n\t/**\n\t * The v1 session facade over the runtime's **current** session\n\t * (`createCodingAgentFacade(runtime.session)`), re-derived on every call.\n\t *\n\t * Replacements (newSession/switchSession/fork/importFromJsonl) invalidate the\n\t * previous session, so a facade held across one of them would keep reading a\n\t * dead session — call this accessor again after a replacement instead of\n\t * caching it. Complement to `setRebindSession`: that hook keeps host-held\n\t * *internal* session references fresh (extension binding, host state), while\n\t * this member is the stable-surface way to reach the current session without\n\t * the raw `AgentSession` ever leaving the adapter (D-063).\n\t */\n\tgetSessionFacade(): CodingAgentFacadeV1;\n\n\t// --- Session selector reads (SessionManager statics + instance reads) ---\n\t/**\n\t * Delegates to SessionManager.list(cwd, sessionDir) on the current session's\n\t * manager: sessions of the current cwd/session dir, newest first.\n\t */\n\tlistSessions(onProgress?: SessionListProgress): Promise<SessionInfo[]>;\n\t/**\n\t * Delegates to SessionManager.listAll() on the current session's manager:\n\t * the default session dir when the session uses it, the session's own dir\n\t * otherwise (same branch as the interactive selector).\n\t */\n\tlistAllSessions(onProgress?: SessionListProgress): Promise<SessionInfo[]>;\n\t/** Delegates to SessionManager.getSessionFile() on the current session's manager. */\n\tgetSessionFile(): string | undefined;\n\t/** Delegates to SessionManager.getSessionDir() on the current session's manager. */\n\tgetSessionDir(): string;\n\t/** Delegates to SessionManager.usesDefaultSessionDir() on the current session's manager. */\n\tusesDefaultSessionDir(): boolean;\n\t/** Delegates to SessionManager.isPersisted() on the current session's manager. */\n\tisPersisted(): boolean;\n\t/** Delegates to SessionManager.getSessionId() on the current session's manager. */\n\tgetSessionId(): string;\n}\n\n/**\n * Creates a runtime facade v1 view over one AgentSessionRuntime. Pure wrapper:\n * holds no state of its own. Derive on each access (or after a rebind) so the\n * wrapper always reads the runtime's current session.\n */\nexport function createCodingAgentRuntimeFacade(runtime: AgentSessionRuntime): CodingAgentRuntimeFacadeV1 {\n\tconst sessionManager = () => runtime.session.sessionManager;\n\treturn {\n\t\tversion: 1,\n\t\t// Rest-args forwarding keeps the delegation call-arity identical to a\n\t\t// direct runtime call (optional options are not materialized as\n\t\t// explicit undefined arguments).\n\t\tnewSession: (...args) => runtime.newSession(...args),\n\t\tfork: (...args) => runtime.fork(...args),\n\t\tswitchSession: (...args) => runtime.switchSession(...args),\n\t\timportFromJsonl: (...args) => runtime.importFromJsonl(...args),\n\t\tdispose: () => runtime.dispose(),\n\t\tsetBeforeSessionInvalidate: (beforeSessionInvalidate) =>\n\t\t\truntime.setBeforeSessionInvalidate(beforeSessionInvalidate),\n\t\tsetRebindSession: (rebindSession) => runtime.setRebindSession(rebindSession),\n\t\t// Re-projected per call so the accessor follows the runtime's current session\n\t\t// across replacements (the v1 session facade holds no state of its own).\n\t\tgetSessionFacade: () => createCodingAgentFacade(runtime.session),\n\t\tlistSessions: (onProgress) =>\n\t\t\tSessionManager.list(sessionManager().getCwd(), sessionManager().getSessionDir(), onProgress),\n\t\tlistAllSessions: (onProgress) =>\n\t\t\tsessionManager().usesDefaultSessionDir()\n\t\t\t\t? SessionManager.listAll(onProgress)\n\t\t\t\t: SessionManager.listAll(sessionManager().getSessionDir(), onProgress),\n\t\tgetSessionFile: () => sessionManager().getSessionFile(),\n\t\tgetSessionDir: () => sessionManager().getSessionDir(),\n\t\tusesDefaultSessionDir: () => sessionManager().usesDefaultSessionDir(),\n\t\tisPersisted: () => sessionManager().isPersisted(),\n\t\tgetSessionId: () => sessionManager().getSessionId(),\n\t};\n}\n"]}

package/dist/core/facade/index.d.ts

@@ -0,0 +1,6 @@
+/** Stable facade entry point (docs/design/稳定门面统一入口设计.md). */
+export type { CodingAgentFacadePromptOptionsV1, CodingAgentFacadeV1, } from "./coding-agent-facade.ts";
+export { createCodingAgentFacade } from "./coding-agent-facade.ts";
+export type { CodingAgentRuntimeFacadeV1 } from "./coding-agent-runtime-facade.ts";
+export { createCodingAgentRuntimeFacade } from "./coding-agent-runtime-facade.ts";
+//# sourceMappingURL=index.d.ts.map

package/dist/core/facade/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/facade/index.ts"],"names":[],"mappings":"AAAA,iFAA6D;AAC7D,YAAY,EACX,gCAAgC,EAChC,mBAAmB,GACnB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,uBAAuB,EAAE,MAAM,0BAA0B,CAAC;AACnE,YAAY,EAAE,0BAA0B,EAAE,MAAM,kCAAkC,CAAC;AACnF,OAAO,EAAE,8BAA8B,EAAE,MAAM,kCAAkC,CAAC","sourcesContent":["/** Stable facade entry point (docs/design/稳定门面统一入口设计.md). */\nexport type {\n\tCodingAgentFacadePromptOptionsV1,\n\tCodingAgentFacadeV1,\n} from \"./coding-agent-facade.ts\";\nexport { createCodingAgentFacade } from \"./coding-agent-facade.ts\";\nexport type { CodingAgentRuntimeFacadeV1 } from \"./coding-agent-runtime-facade.ts\";\nexport { createCodingAgentRuntimeFacade } from \"./coding-agent-runtime-facade.ts\";\n"]}

package/dist/core/facade/index.js

@@ -0,0 +1,3 @@
+export { createCodingAgentFacade } from "./coding-agent-facade.js";
+export { createCodingAgentRuntimeFacade } from "./coding-agent-runtime-facade.js";
+//# sourceMappingURL=index.js.map

package/dist/core/facade/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/core/facade/index.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,uBAAuB,EAAE,MAAM,0BAA0B,CAAC;AAEnE,OAAO,EAAE,8BAA8B,EAAE,MAAM,kCAAkC,CAAC","sourcesContent":["/** Stable facade entry point (docs/design/稳定门面统一入口设计.md). */\nexport type {\n\tCodingAgentFacadePromptOptionsV1,\n\tCodingAgentFacadeV1,\n} from \"./coding-agent-facade.ts\";\nexport { createCodingAgentFacade } from \"./coding-agent-facade.ts\";\nexport type { CodingAgentRuntimeFacadeV1 } from \"./coding-agent-runtime-facade.ts\";\nexport { createCodingAgentRuntimeFacade } from \"./coding-agent-runtime-facade.ts\";\n"]}

package/dist/core/footer-data-provider.d.ts

@@ -0,0 +1,57 @@
+export type GitPaths = {
+    repoDir: string;
+    commonGitDir: string;
+    headPath: string;
+};
+/**
+ * Find git metadata paths by walking up from cwd.
+ * Handles both regular git repos (.git is a directory) and worktrees (.git is a file).
+ */
+export declare function findGitPaths(cwd: string): GitPaths | null;
+/**
+ * Provides git branch and extension statuses - data not otherwise accessible to extensions.
+ * Context usage on ctx.getContextUsage(), token stats on ctx.sessionManager.getEntries(), model info on ctx.model.
+ */
+export declare class FooterDataProvider {
+    private cwd;
+    private static readonly WATCH_DEBOUNCE_MS;
+    private cachedBranch;
+    private gitPaths;
+    private headWatcher;
+    private headWatchFilePath;
+    private headWatchFileListener;
+    private reftableWatcher;
+    private reftableTablesListWatcher;
+    private reftableTablesListPath;
+    private branchChangeCallbacks;
+    private availableProviderCount;
+    private refreshTimer;
+    private gitWatcherRetryTimer;
+    private refreshInFlight;
+    private refreshPending;
+    private disposed;
+    constructor(cwd: string);
+    /** Current git branch, null if not in repo, "detached" if detached HEAD */
+    getGitBranch(): string | null;
+    /** Subscribe to git branch changes. Returns unsubscribe function. */
+    onBranchChange(callback: () => void): () => void;
+    /** Number of unique providers with available models (for footer display) */
+    getAvailableProviderCount(): number;
+    /** Internal: update available provider count */
+    setAvailableProviderCount(count: number): void;
+    setCwd(cwd: string): void;
+    /** Internal: cleanup */
+    dispose(): void;
+    private notifyBranchChange;
+    private scheduleRefresh;
+    private refreshGitBranchAsync;
+    private resolveGitBranchSync;
+    private resolveGitBranchAsync;
+    private clearGitWatchers;
+    private scheduleGitWatcherRetry;
+    private handleGitWatcherError;
+    private setupGitWatcher;
+}
+/** Read-only view for the TUI footer - excludes setAvailableProviderCount and dispose */
+export type ReadonlyFooterDataProvider = Pick<FooterDataProvider, "getGitBranch" | "getAvailableProviderCount" | "onBranchChange">;
+//# sourceMappingURL=footer-data-provider.d.ts.map

package/dist/core/footer-data-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"footer-data-provider.d.ts","sourceRoot":"","sources":["../../src/core/footer-data-provider.ts"],"names":[],"mappings":"AAKA,MAAM,MAAM,QAAQ,GAAG;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF;;;GAGG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,QAAQ,GAAG,IAAI,CAgCzD;AAgDD;;;GAGG;AACH,qBAAa,kBAAkB;IAC9B,OAAO,CAAC,GAAG,CAAS;IACpB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,iBAAiB,CAAO;IAEhD,OAAO,CAAC,YAAY,CAAwC;IAC5D,OAAO,CAAC,QAAQ,CAA0C;IAC1D,OAAO,CAAC,WAAW,CAA0B;IAC7C,OAAO,CAAC,iBAAiB,CAAuB;IAChD,OAAO,CAAC,qBAAqB,CAA4D;IACzF,OAAO,CAAC,eAAe,CAA0B;IACjD,OAAO,CAAC,yBAAyB,CAA0B;IAC3D,OAAO,CAAC,sBAAsB,CAAuB;IACrD,OAAO,CAAC,qBAAqB,CAAyB;IACtD,OAAO,CAAC,sBAAsB,CAAK;IACnC,OAAO,CAAC,YAAY,CAA8C;IAClE,OAAO,CAAC,oBAAoB,CAA8C;IAC1E,OAAO,CAAC,eAAe,CAAS;IAChC,OAAO,CAAC,cAAc,CAAS;IAC/B,OAAO,CAAC,QAAQ,CAAS;IAEzB,YAAY,GAAG,EAAE,MAAM,EAItB;IAED,2EAA2E;IAC3E,YAAY,IAAI,MAAM,GAAG,IAAI,CAK5B;IAED,qEAAqE;IACrE,cAAc,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI,CAG/C;IAED,4EAA4E;IAC5E,yBAAyB,IAAI,MAAM,CAElC;IAED,gDAAgD;IAChD,yBAAyB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAE7C;IAED,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAexB;IAED,wBAAwB;IACxB,OAAO,IAAI,IAAI,CAQd;IAED,OAAO,CAAC,kBAAkB;IAI1B,OAAO,CAAC,eAAe;YAYT,qBAAqB;IA0BnC,OAAO,CAAC,oBAAoB;YAcd,qBAAqB;IAgBnC,OAAO,CAAC,gBAAgB;IAsBxB,OAAO,CAAC,uBAAuB;IAW/B,OAAO,CAAC,qBAAqB;IAK7B,OAAO,CAAC,eAAe;CA6EvB;AAED,yFAAyF;AACzF,MAAM,MAAM,0BAA0B,GAAG,IAAI,CAC5C,kBAAkB,EAClB,cAAc,GAAG,2BAA2B,GAAG,gBAAgB,CAC/D,CAAC","sourcesContent":["import { type ExecFileException, execFile, spawnSync } from \"child_process\";\nimport { existsSync, type FSWatcher, readFileSync, type Stats, statSync, unwatchFile, watchFile } from \"fs\";\nimport { dirname, join, resolve } from \"path\";\nimport { closeWatcher, FS_WATCH_RETRY_DELAY_MS, watchWithErrorHandler } from \"../utils/fs-watch.ts\";\n\nexport type GitPaths = {\n\trepoDir: string;\n\tcommonGitDir: string;\n\theadPath: string;\n};\n\n/**\n * Find git metadata paths by walking up from cwd.\n * Handles both regular git repos (.git is a directory) and worktrees (.git is a file).\n */\nexport function findGitPaths(cwd: string): GitPaths | null {\n\tlet dir = cwd;\n\twhile (true) {\n\t\tconst gitPath = join(dir, \".git\");\n\t\tif (existsSync(gitPath)) {\n\t\t\ttry {\n\t\t\t\tconst stat = statSync(gitPath);\n\t\t\t\tif (stat.isFile()) {\n\t\t\t\t\tconst content = readFileSync(gitPath, \"utf8\").trim();\n\t\t\t\t\tif (content.startsWith(\"gitdir: \")) {\n\t\t\t\t\t\tconst gitDir = resolve(dir, content.slice(8).trim());\n\t\t\t\t\t\tconst headPath = join(gitDir, \"HEAD\");\n\t\t\t\t\t\tif (!existsSync(headPath)) return null;\n\t\t\t\t\t\tconst commonDirPath = join(gitDir, \"commondir\");\n\t\t\t\t\t\tconst commonGitDir = existsSync(commonDirPath)\n\t\t\t\t\t\t\t? resolve(gitDir, readFileSync(commonDirPath, \"utf8\").trim())\n\t\t\t\t\t\t\t: gitDir;\n\t\t\t\t\t\treturn { repoDir: dir, commonGitDir, headPath };\n\t\t\t\t\t}\n\t\t\t\t} else if (stat.isDirectory()) {\n\t\t\t\t\tconst headPath = join(gitPath, \"HEAD\");\n\t\t\t\t\tif (!existsSync(headPath)) return null;\n\t\t\t\t\treturn { repoDir: dir, commonGitDir: gitPath, headPath };\n\t\t\t\t}\n\t\t\t} catch {\n\t\t\t\treturn null;\n\t\t\t}\n\t\t}\n\t\tconst parent = dirname(dir);\n\t\tif (parent === dir) return null;\n\t\tdir = parent;\n\t}\n}\n\n/** Ask git for the current branch. Returns null on detached HEAD or if git is unavailable. */\nfunction resolveBranchWithGitSync(repoDir: string): string | null {\n\tconst result = spawnSync(\"git\", [\"--no-optional-locks\", \"symbolic-ref\", \"--quiet\", \"--short\", \"HEAD\"], {\n\t\tcwd: repoDir,\n\t\tencoding: \"utf8\",\n\t\tstdio: [\"ignore\", \"pipe\", \"ignore\"],\n\t});\n\tconst branch = result.status === 0 ? result.stdout.trim() : \"\";\n\treturn branch || null;\n}\n\n/** Ask git for the current branch asynchronously. Returns null on detached HEAD or if git is unavailable. */\nfunction resolveBranchWithGitAsync(repoDir: string): Promise<string | null> {\n\treturn new Promise((resolvePromise) => {\n\t\texecFile(\n\t\t\t\"git\",\n\t\t\t[\"--no-optional-locks\", \"symbolic-ref\", \"--quiet\", \"--short\", \"HEAD\"],\n\t\t\t{\n\t\t\t\tcwd: repoDir,\n\t\t\t\tencoding: \"utf8\",\n\t\t\t},\n\t\t\t(error: ExecFileException | null, stdout: string) => {\n\t\t\t\tif (error) {\n\t\t\t\t\tresolvePromise(null);\n\t\t\t\t\treturn;\n\t\t\t\t}\n\t\t\t\tconst branch = stdout.trim();\n\t\t\t\tresolvePromise(branch || null);\n\t\t\t},\n\t\t);\n\t});\n}\n\nfunction isWslEnvironment(): boolean {\n\treturn process.platform === \"linux\" && !!(process.env.WSL_DISTRO_NAME || process.env.WSL_INTEROP);\n}\n\nfunction isWindowsMountedRepoPath(repoDir: string): boolean {\n\treturn /^\\/mnt\\/[a-z](?:\\/|$)/i.test(repoDir);\n}\n\nfunction shouldPollGitHead(repoDir: string): boolean {\n\t// v8 ignore next -- 需 WSL 环境变量与 /mnt/ 挂载路径同时成立，测试与 CI（含 Linux runner）均不满足\n\treturn isWslEnvironment() && isWindowsMountedRepoPath(repoDir);\n}\n\n/**\n * Provides git branch and extension statuses - data not otherwise accessible to extensions.\n * Context usage on ctx.getContextUsage(), token stats on ctx.sessionManager.getEntries(), model info on ctx.model.\n */\nexport class FooterDataProvider {\n\tprivate cwd: string;\n\tprivate static readonly WATCH_DEBOUNCE_MS = 500;\n\n\tprivate cachedBranch: string | null | undefined = undefined;\n\tprivate gitPaths: GitPaths | null | undefined = undefined;\n\tprivate headWatcher: FSWatcher | null = null;\n\tprivate headWatchFilePath: string | null = null;\n\tprivate headWatchFileListener: ((current: Stats, previous: Stats) => void) | null = null;\n\tprivate reftableWatcher: FSWatcher | null = null;\n\tprivate reftableTablesListWatcher: FSWatcher | null = null;\n\tprivate reftableTablesListPath: string | null = null;\n\tprivate branchChangeCallbacks = new Set<() => void>();\n\tprivate availableProviderCount = 0;\n\tprivate refreshTimer: ReturnType<typeof setTimeout> | null = null;\n\tprivate gitWatcherRetryTimer: ReturnType<typeof setTimeout> | null = null;\n\tprivate refreshInFlight = false;\n\tprivate refreshPending = false;\n\tprivate disposed = false;\n\n\tconstructor(cwd: string) {\n\t\tthis.cwd = cwd;\n\t\tthis.gitPaths = findGitPaths(cwd);\n\t\tthis.setupGitWatcher();\n\t}\n\n\t/** Current git branch, null if not in repo, \"detached\" if detached HEAD */\n\tgetGitBranch(): string | null {\n\t\tif (this.cachedBranch === undefined) {\n\t\t\tthis.cachedBranch = this.resolveGitBranchSync();\n\t\t}\n\t\treturn this.cachedBranch;\n\t}\n\n\t/** Subscribe to git branch changes. Returns unsubscribe function. */\n\tonBranchChange(callback: () => void): () => void {\n\t\tthis.branchChangeCallbacks.add(callback);\n\t\treturn () => this.branchChangeCallbacks.delete(callback);\n\t}\n\n\t/** Number of unique providers with available models (for footer display) */\n\tgetAvailableProviderCount(): number {\n\t\treturn this.availableProviderCount;\n\t}\n\n\t/** Internal: update available provider count */\n\tsetAvailableProviderCount(count: number): void {\n\t\tthis.availableProviderCount = count;\n\t}\n\n\tsetCwd(cwd: string): void {\n\t\tif (this.cwd === cwd) {\n\t\t\treturn;\n\t\t}\n\n\t\tthis.cwd = cwd;\n\t\tif (this.refreshTimer) {\n\t\t\tclearTimeout(this.refreshTimer);\n\t\t\tthis.refreshTimer = null;\n\t\t}\n\t\tthis.clearGitWatchers();\n\t\tthis.cachedBranch = undefined;\n\t\tthis.gitPaths = findGitPaths(cwd);\n\t\tthis.setupGitWatcher();\n\t\tthis.notifyBranchChange();\n\t}\n\n\t/** Internal: cleanup */\n\tdispose(): void {\n\t\tthis.disposed = true;\n\t\tif (this.refreshTimer) {\n\t\t\tclearTimeout(this.refreshTimer);\n\t\t\tthis.refreshTimer = null;\n\t\t}\n\t\tthis.clearGitWatchers();\n\t\tthis.branchChangeCallbacks.clear();\n\t}\n\n\tprivate notifyBranchChange(): void {\n\t\tfor (const cb of this.branchChangeCallbacks) cb();\n\t}\n\n\tprivate scheduleRefresh(): void {\n\t\tif (this.disposed || this.refreshTimer) return;\n\t\tif (this.refreshInFlight) {\n\t\t\tthis.refreshPending = true;\n\t\t\treturn;\n\t\t}\n\t\tthis.refreshTimer = setTimeout(() => {\n\t\t\tthis.refreshTimer = null;\n\t\t\tvoid this.refreshGitBranchAsync();\n\t\t}, FooterDataProvider.WATCH_DEBOUNCE_MS);\n\t}\n\n\tprivate async refreshGitBranchAsync(): Promise<void> {\n\t\tif (this.disposed) return;\n\t\tif (this.refreshInFlight) {\n\t\t\tthis.refreshPending = true;\n\t\t\treturn;\n\t\t}\n\n\t\tthis.refreshInFlight = true;\n\t\ttry {\n\t\t\tconst nextBranch = await this.resolveGitBranchAsync();\n\t\t\tif (this.disposed) return;\n\t\t\tif (this.cachedBranch !== undefined && this.cachedBranch !== nextBranch) {\n\t\t\t\tthis.cachedBranch = nextBranch;\n\t\t\t\tthis.notifyBranchChange();\n\t\t\t\treturn;\n\t\t\t}\n\t\t\tthis.cachedBranch = nextBranch;\n\t\t} finally {\n\t\t\tthis.refreshInFlight = false;\n\t\t\tif (this.refreshPending && !this.disposed) {\n\t\t\t\tthis.refreshPending = false;\n\t\t\t\tthis.scheduleRefresh();\n\t\t\t}\n\t\t}\n\t}\n\n\tprivate resolveGitBranchSync(): string | null {\n\t\ttry {\n\t\t\tif (!this.gitPaths) return null;\n\t\t\tconst content = readFileSync(this.gitPaths.headPath, \"utf8\").trim();\n\t\t\tif (content.startsWith(\"ref: refs/heads/\")) {\n\t\t\t\tconst branch = content.slice(16);\n\t\t\t\treturn branch === \".invalid\" ? (resolveBranchWithGitSync(this.gitPaths.repoDir) ?? \"detached\") : branch;\n\t\t\t}\n\t\t\treturn \"detached\";\n\t\t} catch {\n\t\t\treturn null;\n\t\t}\n\t}\n\n\tprivate async resolveGitBranchAsync(): Promise<string | null> {\n\t\ttry {\n\t\t\tif (!this.gitPaths) return null;\n\t\t\tconst content = readFileSync(this.gitPaths.headPath, \"utf8\").trim();\n\t\t\tif (content.startsWith(\"ref: refs/heads/\")) {\n\t\t\t\tconst branch = content.slice(16);\n\t\t\t\treturn branch === \".invalid\"\n\t\t\t\t\t? ((await resolveBranchWithGitAsync(this.gitPaths.repoDir)) ?? \"detached\")\n\t\t\t\t\t: branch;\n\t\t\t}\n\t\t\treturn \"detached\";\n\t\t} catch {\n\t\t\treturn null;\n\t\t}\n\t}\n\n\tprivate clearGitWatchers(): void {\n\t\tcloseWatcher(this.headWatcher);\n\t\tthis.headWatcher = null;\n\t\tif (this.headWatchFilePath && this.headWatchFileListener) {\n\t\t\tunwatchFile(this.headWatchFilePath, this.headWatchFileListener);\n\t\t\tthis.headWatchFilePath = null;\n\t\t\tthis.headWatchFileListener = null;\n\t\t}\n\t\tcloseWatcher(this.reftableWatcher);\n\t\tthis.reftableWatcher = null;\n\t\tcloseWatcher(this.reftableTablesListWatcher);\n\t\tthis.reftableTablesListWatcher = null;\n\t\tif (this.reftableTablesListPath) {\n\t\t\tunwatchFile(this.reftableTablesListPath);\n\t\t\tthis.reftableTablesListPath = null;\n\t\t}\n\t\tif (this.gitWatcherRetryTimer) {\n\t\t\tclearTimeout(this.gitWatcherRetryTimer);\n\t\t\tthis.gitWatcherRetryTimer = null;\n\t\t}\n\t}\n\n\tprivate scheduleGitWatcherRetry(): void {\n\t\tif (this.disposed || this.gitWatcherRetryTimer) {\n\t\t\treturn;\n\t\t}\n\n\t\tthis.gitWatcherRetryTimer = setTimeout(() => {\n\t\t\tthis.gitWatcherRetryTimer = null;\n\t\t\tthis.setupGitWatcher();\n\t\t}, FS_WATCH_RETRY_DELAY_MS);\n\t}\n\n\tprivate handleGitWatcherError(): void {\n\t\tthis.clearGitWatchers();\n\t\tthis.scheduleGitWatcherRetry();\n\t}\n\n\tprivate setupGitWatcher(): void {\n\t\tthis.clearGitWatchers();\n\t\tif (!this.gitPaths) return;\n\n\t\tconst pollGitHead = shouldPollGitHead(this.gitPaths.repoDir);\n\n\t\t// Watch the directory containing HEAD, not HEAD itself.\n\t\t// Git uses atomic writes (write temp, rename over HEAD), which changes the inode.\n\t\t// fs.watch on a file stops working after the inode changes.\n\t\tthis.headWatcher = watchWithErrorHandler(\n\t\t\tdirname(this.gitPaths.headPath),\n\t\t\t(_eventType, filename) => {\n\t\t\t\tif (!filename || filename === \"HEAD\") {\n\t\t\t\t\tthis.scheduleRefresh();\n\t\t\t\t}\n\t\t\t},\n\t\t\t() => this.handleGitWatcherError(),\n\t\t);\n\t\t// v8 ignore next -- pollGitHead 需 WSL + /mnt/ 挂载路径，测试与 CI 环境恒为 false\n\t\tif (pollGitHead) {\n\t\t\tthis.headWatchFilePath = this.gitPaths.headPath;\n\t\t\tthis.headWatchFileListener = (current, previous) => {\n\t\t\t\tif (\n\t\t\t\t\tcurrent.mtimeMs !== previous.mtimeMs ||\n\t\t\t\t\tcurrent.ctimeMs !== previous.ctimeMs ||\n\t\t\t\t\tcurrent.size !== previous.size\n\t\t\t\t) {\n\t\t\t\t\tthis.scheduleRefresh();\n\t\t\t\t}\n\t\t\t};\n\t\t\twatchFile(this.headWatchFilePath, { interval: 1000 }, this.headWatchFileListener);\n\t\t}\n\t\t// v8 ignore next -- headWatcher 仅在 watch 同步抛错时为 null，此时目录已被 findGitPaths 验证存在\n\t\tif (!this.headWatcher && !pollGitHead) {\n\t\t\treturn;\n\t\t}\n\n\t\t// In reftable repos, branch switches update files in the reftable directory\n\t\t// instead of HEAD. Watch it separately so the footer picks up those changes.\n\t\tconst reftableDir = join(this.gitPaths.commonGitDir, \"reftable\");\n\t\tif (existsSync(reftableDir)) {\n\t\t\tthis.reftableWatcher = watchWithErrorHandler(\n\t\t\t\treftableDir,\n\t\t\t\t() => {\n\t\t\t\t\tthis.scheduleRefresh();\n\t\t\t\t},\n\t\t\t\t() => this.handleGitWatcherError(),\n\t\t\t);\n\t\t\tif (!this.reftableWatcher) {\n\t\t\t\treturn;\n\t\t\t}\n\n\t\t\tconst tablesListPath = join(reftableDir, \"tables.list\");\n\t\t\tif (existsSync(tablesListPath)) {\n\t\t\t\tthis.reftableTablesListPath = tablesListPath;\n\t\t\t\tthis.reftableTablesListWatcher = watchWithErrorHandler(\n\t\t\t\t\ttablesListPath,\n\t\t\t\t\t() => {\n\t\t\t\t\t\tthis.scheduleRefresh();\n\t\t\t\t\t},\n\t\t\t\t\t() => this.handleGitWatcherError(),\n\t\t\t\t);\n\t\t\t\tif (!this.reftableTablesListWatcher) {\n\t\t\t\t\treturn;\n\t\t\t\t}\n\t\t\t\twatchFile(tablesListPath, { interval: 250 }, (current, previous) => {\n\t\t\t\t\tif (\n\t\t\t\t\t\tcurrent.mtimeMs !== previous.mtimeMs ||\n\t\t\t\t\t\tcurrent.ctimeMs !== previous.ctimeMs ||\n\t\t\t\t\t\tcurrent.size !== previous.size\n\t\t\t\t\t) {\n\t\t\t\t\t\tthis.scheduleRefresh();\n\t\t\t\t\t}\n\t\t\t\t});\n\t\t\t}\n\t\t}\n\t}\n}\n\n/** Read-only view for the TUI footer - excludes setAvailableProviderCount and dispose */\nexport type ReadonlyFooterDataProvider = Pick<\n\tFooterDataProvider,\n\t\"getGitBranch\" | \"getAvailableProviderCount\" | \"onBranchChange\"\n>;\n"]}