fix: resolve replay script paths from caller cwd (#77)

Author: thymikee

src/__tests__/cli-diagnostics.test.ts

@@ -72,6 +72,7 @@ test('cli forwards --debug as verbose/debug metadata', async () => {
   assert.equal(result.calls.length, 1);
   assert.equal(result.calls[0]?.flags?.verbose, true);
   assert.equal(result.calls[0]?.meta?.debug, true);
+  assert.equal(result.calls[0]?.meta?.cwd, process.cwd());
   assert.equal(typeof result.calls[0]?.meta?.requestId, 'string');
 });
 

src/cli.ts

@@ -108,6 +108,7 @@ export async function runCli(argv: string[], deps: CliDeps = DEFAULT_CLI_DEPS):
           meta: {
             requestId,
             debug: Boolean(flags.verbose),
+            cwd: process.cwd(),
           },
         });
       try {

src/daemon-client.ts

@@ -56,6 +56,7 @@ export async function sendToDaemon(req: Omit<DaemonRequest, 'token'>): Promise<D
     meta: {
       requestId,
       debug,
+      cwd: req.meta?.cwd,
     },
   };
   emitDiagnostic({

src/daemon/__tests__/session-store.test.ts

@@ -21,6 +21,19 @@ function makeSession(name: string): SessionState {
   };
 }
 
+test('expandHome resolves tilde, relative-with-cwd, and absolute paths', () => {
+  const homePath = SessionStore.expandHome('~/flows/replay.ad');
+  assert.equal(homePath.startsWith(os.homedir()), true);
+  assert.equal(homePath.endsWith(path.join('flows', 'replay.ad')), true);
+
+  const relativePath = SessionStore.expandHome('workflows/replay.ad', '/tmp/agent-device-cwd');
+  assert.equal(relativePath, path.resolve('/tmp/agent-device-cwd', 'workflows/replay.ad'));
+
+  const absoluteInput = path.resolve('/tmp', 'agent-device-absolute.ad');
+  const absolutePath = SessionStore.expandHome(absoluteInput, '/tmp/ignored-cwd');
+  assert.equal(absolutePath, absoluteInput);
+});
+
 test('recordAction stores normalized action entries', () => {
   const store = new SessionStore(path.join(os.tmpdir(), 'agent-device-tests'));
   const session = makeSession('default');

src/daemon/handlers/__tests__/session.test.ts

@@ -1014,6 +1014,39 @@ test('replay parses open --relaunch flag and replays open with relaunch semantic
   assert.equal(invoked[0]?.flags?.relaunch, true);
 });
 
+test('replay resolves relative script path against request cwd', async () => {
+  const sessionStore = makeSessionStore();
+  const replayRoot = fs.mkdtempSync(path.join(os.tmpdir(), 'agent-device-replay-cwd-'));
+  const replayDir = path.join(replayRoot, 'workflows');
+  fs.mkdirSync(replayDir, { recursive: true });
+  fs.writeFileSync(path.join(replayDir, 'flow.ad'), 'open "Settings"\n');
+
+  const invoked: DaemonRequest[] = [];
+  const response = await handleSessionCommands({
+    req: {
+      token: 't',
+      session: 'default',
+      command: 'replay',
+      positionals: ['workflows/flow.ad'],
+      flags: {},
+      meta: { cwd: replayRoot },
+    },
+    sessionName: 'default',
+    logPath: path.join(os.tmpdir(), 'daemon.log'),
+    sessionStore,
+    invoke: async (req) => {
+      invoked.push(req);
+      return { ok: true, data: {} };
+    },
+  });
+
+  assert.ok(response);
+  assert.equal(response?.ok, true);
+  assert.equal(invoked.length, 1);
+  assert.equal(invoked[0]?.command, 'open');
+  assert.deepEqual(invoked[0]?.positionals, ['Settings']);
+});
+
 test('replay parses press series flags and passes them to invoke', async () => {
   const sessionStore = makeSessionStore();
   const replayRoot = fs.mkdtempSync(path.join(os.tmpdir(), 'agent-device-replay-press-series-'));

src/daemon/handlers/session.ts

@@ -544,7 +544,7 @@ export async function handleSessionCommands(params: {
       return { ok: false, error: { code: 'INVALID_ARGS', message: 'replay requires a path' } };
     }
     try {
-      const resolved = SessionStore.expandHome(filePath);
+      const resolved = SessionStore.expandHome(filePath, req.meta?.cwd);
       const script = fs.readFileSync(resolved, 'utf8');
       const firstNonWhitespace = script.trimStart()[0];
       if (firstNonWhitespace === '{' || firstNonWhitespace === '[') {

src/daemon/session-store.ts

@@ -91,10 +91,13 @@ export class SessionStore {
     return path.join(this.sessionsDir, `${safeName}-${timestamp}.trace.log`);
   }
 
-  static expandHome(filePath: string): string {
+  static expandHome(filePath: string, cwd?: string): string {
     if (filePath.startsWith('~/')) {
       return path.join(os.homedir(), filePath.slice(2));
     }
+    if (cwd && !path.isAbsolute(filePath)) {
+      return path.resolve(cwd, filePath);
+    }
     return path.resolve(filePath);
   }
 

src/daemon/types.ts

@@ -12,6 +12,7 @@ export type DaemonRequest = {
   meta?: {
     requestId?: string;
     debug?: boolean;
+    cwd?: string;
   };
 };