merge: wave 2 executor (01-02) into main

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

paperclip-reference/cli/src/utils/path-resolver.ts

@@ -0,0 +1,25 @@
+import fs from "node:fs";
+import path from "node:path";
+import { expandHomePrefix } from "../config/home.js";
+
+function unique(items: string[]): string[] {
+  return Array.from(new Set(items));
+}
+
+export function resolveRuntimeLikePath(value: string, configPath?: string): string {
+  const expanded = expandHomePrefix(value);
+  if (path.isAbsolute(expanded)) return path.resolve(expanded);
+
+  const cwd = process.cwd();
+  const configDir = configPath ? path.dirname(configPath) : null;
+  const workspaceRoot = configDir ? path.resolve(configDir, "..") : cwd;
+
+  const candidates = unique([
+    ...(configDir ? [path.resolve(configDir, expanded)] : []),
+    path.resolve(workspaceRoot, "server", expanded),
+    path.resolve(workspaceRoot, expanded),
+    path.resolve(cwd, expanded),
+  ]);
+
+  return candidates.find((candidate) => fs.existsSync(candidate)) ?? candidates[0];
+}