@adhdev/daemon-core 0.9.82-rc.407 → 0.9.82-rc.409

package/dist/git/git-status.d.ts

@@ -1,8 +1,19 @@
 import type { GitRepoStatus } from './git-types.js';
 import { type DaemonBuildInfo } from '../build-info.js';
 import { type ChangeImpactConfig } from './change-impact-config.js';
+/**
+ * TTL for the happy-path result cache (C1). reconcile fires every 4s and mesh_status
+ * is polled; a single getGitRepoStatus on a 1-submodule repo spawns ~13-15 git
+ * processes (+ optional network fetch) which on Windows is ~10-15s. Within this short
+ * window, repeat callers that share the same option shape are served the already
+ * collected status instead of re-shelling. Kept well under the 4s reconcile cadence so
+ * a genuinely fresh probe still happens at least roughly once per reconcile tick.
+ */
+export declare const GIT_STATUS_CACHE_TTL_MS = 1500;
 /** Test seam: clear the last-known-good status cache between cases. */
 export declare function __resetGitStatusCacheForTests(): void;
+/** Alias matching the task's requested name. */
+export declare const __resetGitStatusCache: typeof __resetGitStatusCacheForTests;
 /** Test-only introspection: number of memoized Change Impact evaluations. */
 export declare function __changeImpactEvalCacheSizeForTests(): number;
 export interface GitStatusOptions {
@@ -16,6 +27,18 @@ export interface GitStatusOptions {
      * Callers should opt into this only for convergence-critical surfaces.
      */
     refreshUpstream?: boolean;
+    /**
+     * When true, bypass the C1 TTL result cache: always re-collect a fresh status
+     * (ignoring any cached entry younger than GIT_STATUS_CACHE_TTL_MS). The freshly
+     * collected result still UPDATES the cache so subsequent normal callers benefit.
+     *
+     * Mutating / decision callers (mesh_fast_forward preflight + post-merge re-read,
+     * refine submodule alignment pre/post status) MUST set this — acting on a stale
+     * ahead/behind or submodule sync verdict is the primary correctness hazard of the
+     * cache. Read-only/observe callers (mesh_status, git-monitor, reconcile) leave it
+     * unset and enjoy the dedup.
+     */
+    forceFresh?: boolean;
     /**
      * Test/override seam for the daemon build stamp used by the stale-build
      * detector. Production callers omit this so the real baked-in build commit
@@ -34,9 +57,20 @@ export interface GitStatusOptions {
      */
     changeImpactConfig?: ChangeImpactConfig | null;
 }
+/**
+ * C2: minimum interval between actual `git fetch` network calls per workspace. A
+ * refreshUpstream caller within this window does NOT re-fetch; it serves ahead/behind
+ * from the locally-re-read porcelain (which is always fresh every call). So
+ * refreshUpstream becomes "fetch if the local remote-tracking ref is stale" rather than
+ * "always pay a network round trip". Only the upstream ahead/behind can age up to this
+ * throttle; local working-tree status never does.
+ */
+export declare const GIT_FETCH_THROTTLE_MS = 30000;
 export declare function getGitRepoStatus(workspace: string, options?: GitStatusOptions): Promise<GitRepoStatus>;
 interface ParsedPorcelainStatus {
     branch: string | null;
+    /** Full HEAD object id from `# branch.oid`, or null when detached/unborn. */
+    headOid: string | null;
     upstream: string | null;
     ahead: number;
     behind: number;

package/dist/index.d.ts

@@ -51,7 +51,7 @@ export { fastForwardMeshNode } from './mesh/mesh-fast-forward.js';
 export type { MeshFastForwardNodeArgs, MeshFastForwardPlannedStep, MeshFastForwardResult } from './mesh/mesh-fast-forward.js';
 export { buildMeshLedgerReconciliationEvidence, buildMeshLedgerReplicaEvidence } from './mesh/mesh-ledger-reconciliation.js';
 export type { AnyLedgerSlice, MeshLedgerReconciliationEvidence, MeshLedgerReplicaEvidence, MeshLedgerReplicaStatus } from './mesh/mesh-ledger-reconciliation.js';
-export { enqueueTask, recordDirectDispatchTask, getQueue, claimNextTask, updateTaskStatus, updateSessionTaskStatus, cancelTask, requeueTask, getMeshQueueStats, getMeshQueueRevision, normalizeMeshTaskMode, validateMeshTaskModeRequest, buildMeshNodeCapabilityTags, nodeSatisfiesRequiredTags, normalizeMeshCapabilityTags, resolveConvergeRequiredTags, insertDirectDispatch, getActiveDirectDispatches, updateDirectDispatchStatus, cleanupTerminalDirectDispatches, markStaleDirectDispatches, deleteDirectDispatchesByTaskId, recordMeshToolCall, assertNoDependencyCycle, hasPendingDependents, describeTaskDependencyState } from './mesh/mesh-work-queue.js';
+export { enqueueTask, recordDirectDispatchTask, getQueue, claimNextTask, updateTaskStatus, updateSessionTaskStatus, cancelTask, requeueTask, getMeshQueueStats, getMeshQueueRevision, normalizeMeshTaskMode, validateMeshTaskModeRequest, isTaskReadonly, buildMeshNodeCapabilityTags, nodeSatisfiesRequiredTags, normalizeMeshCapabilityTags, resolveConvergeRequiredTags, insertDirectDispatch, getActiveDirectDispatches, updateDirectDispatchStatus, cleanupTerminalDirectDispatches, markStaleDirectDispatches, deleteDirectDispatchesByTaskId, recordMeshToolCall, assertNoDependencyCycle, hasPendingDependents, describeTaskDependencyState } from './mesh/mesh-work-queue.js';
 export type { MeshWorkQueueEntry, MeshTaskStatus, MeshTaskMode, MeshWorkQueueStats, MeshQueueMutationOptions, MeshTaskModeValidationResult, DirectDispatchRecord, MeshToolCallRateResult } from './mesh/mesh-work-queue.js';
 export { buildCompactStaleDirectWorkSummary, buildMeshActiveWork, buildMeshActiveWorkSummary, classifyStaleDirectForPrune, pruneStaleDirectDispatches, PRUNABLE_ORPHAN_STALE_REASONS } from './mesh/mesh-active-work.js';
 export type { StaleDirectPruneClassification, StaleDirectPruneResult, PruneStaleDirectDispatchesOptions } from './mesh/mesh-active-work.js';