On a mount that follows symlinks, one file reached through two link spellings is two workspace entries, and edit_many stores two diverging copies #631

// Probe (Ruth-2424): one file reached through two spellings on a mount that follows
// symlinks: `real/notes.txt` and `link/notes.txt`, where `link` is a symlink
// to the mount's own directory `real`. What read, edit_many and the push to
// disk do with the two spellings.
// Run with tsx from a directory beside an agent-framework checkout's src.
import { mkdirSync, mkdtempSync, readFileSync, rmSync, symlinkSync, writeFileSync, lstatSync, readlinkSync } from 'node:fs';
import { tmpdir } from 'node:os';
import { join } from 'node:path';
import { JsStore } from '@animalabs/chronicle';
import { WorkspaceModule } from '../src/modules/workspace/index.js';
import type { ToolResult } from '../src/types/events.js';

console.log(`node ${process.version}, ${process.platform}`);

const root = mkdtempSync(join(tmpdir(), 'probe-'));
const log = (line: string) => console.log(line.split(root).join('<tmp>'));
const dir = join(root, 'mount');
mkdirSync(join(dir, 'real'), { recursive: true });
writeFileSync(join(dir, 'real', 'notes.txt'), 'alpha\nbeta\n');
symlinkSync('real', join(dir, 'link'));
log(`mount ${dir}: real/notes.txt = ${JSON.stringify(readFileSync(join(dir, 'real', 'notes.txt'), 'utf8'))}; link -> ${readlinkSync(join(dir, 'link'))} (${lstatSync(join(dir, 'link')).isSymbolicLink() ? 'symlink' : '?'})`);

const store = JsStore.openOrCreate({ path: join(root, 'store') });
const workspace = new WorkspaceModule({
  mounts: [{ name: 'work', path: dir, mode: 'read-write', watch: 'never', autoMaterialize: true, followSymlinks: true }],
});
workspace.initStore(store);
const call = (name: string, input: unknown): Promise<ToolResult> =>
  workspace.handleToolCall({ id: name, name, input } as Parameters<WorkspaceModule['handleToolCall']>[0]);
const brief = (r: ToolResult) => r.success ? `ok ${JSON.stringify(r.data).slice(0, 300)}` : `refused: ${r.error}`;

try {
  for (const p of ['work/real/notes.txt', 'work/link/notes.txt']) {
    const r = await call('read', { path: p, offsetChars: 0, limitChars: 10_000 });
    log(`\nread ${p}: ${r.success ? JSON.stringify((r.data as { content: string }).content) : 'refused: ' + r.error}`);
  }

  const many = await call('edit_many', { edits: [
    { path: 'work/real/notes.txt', oldString: 'alpha', newString: 'ALPHA' },
    { path: 'work/link/notes.txt', oldString: 'beta', newString: 'BETA' },
  ] });
  log(`\nedit_many [real/notes.txt: alpha -> ALPHA, link/notes.txt: beta -> BETA]:\n  ${brief(many)}`);

  log(`\nstore tree after edit_many:`);
  for (const p of ['real/notes.txt', 'link/notes.txt']) {
    const r = await call('read', { path: `work/${p}`, offsetChars: 0, limitChars: 10_000 });
    log(`  read work/${p}: ${r.success ? JSON.stringify((r.data as { content: string }).content) : 'refused: ' + r.error}`);
  }
  log(`\ndisk real/notes.txt after edit_many: ${JSON.stringify(readFileSync(join(dir, 'real', 'notes.txt'), 'utf8'))}`);
  const status = await call('status', {});
  log(`\nstatus: ${JSON.stringify(status.data ?? status.error).slice(0, 1200)}`);
} finally {
  store.close();
  rmSync(root, { recursive: true, force: true });
}