fix(adt-flow): expose ownership divergence path

packages/adt-flow/src/repository.ts

@@ -299,15 +299,24 @@ export function validateDesiredFiles(files: readonly DesiredFile[]): void {
   }
 }
 
-export async function verifyOwnedHashes(
+export async function findDivergedOwnedPath(
   root: string,
   files: readonly { path: string; hash: string }[],
-): Promise<boolean> {
+): Promise<string | undefined> {
   for (const file of files) {
     const content = await readText(root, file.path);
-    if (content === undefined || sha256(content) !== file.hash) return false;
+    if (content === undefined || sha256(content) !== file.hash) {
+      return file.path;
+    }
   }
-  return true;
+  return undefined;
+}
+
+export async function verifyOwnedHashes(
+  root: string,
+  files: readonly { path: string; hash: string }[],
+): Promise<boolean> {
+  return (await findDivergedOwnedPath(root, files)) === undefined;
 }
 
 export async function planRepositoryChanges(

packages/adt-flow/src/service.ts

@@ -14,6 +14,7 @@ import {
 import { repositoryType } from './adt-client-adapter';
 import {
   applyRepositoryPlan,
+  findDivergedOwnedPath,
   planRepositoryChanges,
   readText,
   verifyOwnedHashes,
@@ -1204,11 +1205,12 @@ async function validateIndexedOwnership(
     identity,
     ctx.dependencies.format,
   );
-  if (!(await verifyOwnedHashes(ctx.root, descriptor.ownedFiles))) {
+  const path = await findDivergedOwnedPath(ctx.root, descriptor.ownedFiles);
+  if (path !== undefined) {
     throw new AdtFlowError(
       'working_tree_diverged',
       'An indexed file differs from its recorded content hash.',
-      { object: identity.canonical },
+      { object: identity.canonical, path },
     );
   }
 }

packages/adt-flow/tests/service.test.ts

@@ -669,7 +669,13 @@ describe('transport checkout', () => {
 
     await expect(
       flow.checkout({ root: workspace, transports: ['DEVK900001'], config }),
-    ).rejects.toMatchObject({ code: 'working_tree_diverged' });
+    ).rejects.toMatchObject({
+      code: 'working_tree_diverged',
+      details: {
+        object: expect.any(String),
+        path: 'src/feature/zcl_sample.clas.abap',
+      },
+    });
     expect(ports.readSource).not.toHaveBeenCalled();
     expect(
       await readFile(