Function findQualifyingRootSync

src/core/root-selection.ts:275–289

* The nearest-root walk, qualified: an `openspec/` DIRECTORY alone is * not a root — it must carry a planning shape or a config file. * Without this, the recommended `~/openspec/ ` store layout would * make $HOME a phantom root that captures every command under the * home tree.

(startPath: string)

 * home tree.
 */
function findQualifyingRootSync(startPath: string): string | null {
  let candidate = findRepoPlanningRootSync(startPath);
  while (candidate) {
    const { hasPlanningShape, pointer } = classifyOpenSpecDir(candidate);
    if (hasPlanningShape || pointer.filePath) {
      return candidate;
    }
    const parent = path.dirname(candidate);
    if (parent === candidate) {
      return null;
    }
    candidate = findRepoPlanningRootSync(parent);
  }
  return null;
}

async function resolveNearestOrDeclaredRoot(
  nearestRoot: string,