@amalgm/shell 0.1.111 → 0.1.112

package/dist/user-ground-host.d.ts

@@ -38,6 +38,28 @@ export interface DetectScanEvidence {
     readonly plannedRows?: number;
     readonly records?: number;
     readonly recordBytes?: number;
+    /** Wall time inside readdir/lstat — the traversal's own cost. */
+    readonly walkMs?: number;
+    /** Wall time from the first content capture scheduled to the last settled. */
+    readonly captureMs?: number;
+    /** Summed capture task time. Divided by captureMs it is pool occupancy: at
+     * or near 1 the pool is idle-serial, near its width it is saturated. */
+    readonly captureBusyMs?: number;
+    /** Bytes read and hashed by content capture during this scan. */
+    readonly captureBytes?: number;
+    /** Wall time inside Git index inspection during the walk. */
+    readonly gitMs?: number;
+    /** Wall time proving repository identity through Git, across every
+     * repository. Repositories are sealed one at a time, so this is serial. */
+    readonly repositoryIdentityMs?: number;
+    /** Wall time packing repository transport bytes, across every repository. */
+    readonly repositoryCaptureMs?: number;
+    /** Wall time sealing and re-inspecting repository transport artifacts. */
+    readonly repositorySealMs?: number;
+    /** Wall time resolving stored UUIDs against what the walk found. */
+    readonly reconcileMs?: number;
+    /** Wall time planning and persisting rows once identity is settled. */
+    readonly persistMs?: number;
 }
 export interface UserGroundHostOptions {
     readonly amalgmRoot: string;
@@ -67,6 +89,13 @@ export interface UserGroundHostOptions {
     }) => Promise<void> | void;
     /** Transient, opt-in evidence for exact stage measurement. */
     readonly onFilesStage?: FilesStageObserver;
+    /**
+     * Is stage evidence being read right now? An observer may be permanently
+     * installed while nothing is listening, so the host asks rather than
+     * assumes: counters that cost real work on the critical path are computed
+     * only when the answer is yes.
+     */
+    readonly filesTraceActive?: () => boolean;
 }
 export type WorkspaceAddStage = "intent-recorded" | "materialization-verified" | "rows-committed" | "ground-revealed" | "binding-created" | "watching";
 export interface UserGroundCloseOptions {
@@ -102,6 +131,8 @@ export declare class UserGroundHost {
     readonly port: UserGroundPort;
     constructor(options: UserGroundHostOptions);
     private stage;
+    /** Whether a counter worth real time on the critical path may be computed. */
+    private measuring;
     private reportDetectScan;
     databasePath(identity: UserGroundIdentity): string;
     rows(identity: UserGroundIdentity): GroundRow[];
@@ -180,6 +211,9 @@ export declare class UserGroundHost {
      * resource snapshot. */
     private prepareSnapshotPublication;
     private publishMaterializedSnapshot;
+    /** Close the graph-preparation stage with every leg it spent, so a slow
+     * preparation names the slow part instead of one opaque number. */
+    private finishPreparation;
     /** Which of these heads does the authority hold sealed under the current
      * content contract? Batched so a whole workspace costs a handful of
      * frames; the answer is the only permission to skip an upload. */