pi-fovea 0.18.2 → 0.18.3

package/README.md

@@ -205,7 +205,7 @@ next user prompt instead; it never restarts an idle agent. The compact update
 names changed files, route deltas, and newly relevant files. Shell commands,
 external editors, and agents without Fovea remain `unattributed` rather than
 being guessed, while the path scope still keeps unrelated sibling sandboxes
-quiet. Provenance journals accept either intercepted mutations or explicit trusted SHA-1 transitions, write one bounded replacement per event batch, expire after seven days, and live in
+quiet. Provenance journals accept either intercepted mutations or explicit trusted SHA-1 transitions, preserve supplied commit order, write one bounded replacement per event batch, expire after seven days, and live in
 `$TMPDIR`; repository content remains the drift oracle. Updates list causal
 channels such as calls, imports, shared literals, tests, or co-change history.
 By default Fovea also embeds the refreshed focus context of the top drift target

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pi-fovea",
-  "version": "0.18.2",
+  "version": "0.18.3",
   "description": "Token-budgeted repo mapping for agent sessions: foveated heat diffusion over a cross-language code graph, with progressive disclosure.",
   "type": "module",
   "license": "MIT",

package/src/core/provenance.ts

@@ -13,6 +13,7 @@ interface MutationRecord {
   afterSha?: string;
   owner: string;
   toolCallId: string;
+  commitOrder?: number;
   at: number;
 }
 
@@ -34,6 +35,7 @@ export interface MutationTransition {
   path: string;
   beforeSha?: string | undefined;
   afterSha?: string | undefined;
+  commitOrder?: number | undefined;
 }
 
 type ProvenanceKind = "current-session" | "other-session" | "mixed" | "unattributed";
@@ -114,6 +116,7 @@ export const recordMutationTransitions = async (
       afterSha: transition.afterSha,
       owner,
       toolCallId,
+      ...(transition.commitOrder === undefined ? {} : { commitOrder: transition.commitOrder }),
       at,
     }];
   });
@@ -179,7 +182,10 @@ const readRecords = async (root: string, since: number): Promise<MutationRecord[
       // A concurrent atomic replacement or malformed journal is unattributed.
     }
   }));
-  return records.sort((a, b) => a.at - b.at || a.toolCallId.localeCompare(b.toolCallId));
+  return records.sort((a, b) => a.at - b.at
+    || a.owner.localeCompare(b.owner)
+    || (a.commitOrder ?? Number.MAX_SAFE_INTEGER) - (b.commitOrder ?? Number.MAX_SAFE_INTEGER)
+    || a.toolCallId.localeCompare(b.toolCallId));
 };
 
 const kindForOwners = (owners: Set<string>, currentOwner: string): ProvenanceKind => {