@opum-ai/lore 0.1.0 → 0.2.0

package/src/core/workspace-source.ts

@@ -1,174 +0,0 @@
-/** Explicit workspace manifest and repository resolution boundary. */
-
-import { lstatSync, readFileSync, realpathSync, type Stats } from "node:fs";
-import { dirname, isAbsolute, resolve } from "node:path";
-import type { BacklogAdapter } from "../adapters/backlog";
-import { resolveHeadSha } from "../adapters/git";
-import { LoreError, WarningCollector } from "../errors";
-import { EXPECTED_LADYBUG_STORAGE_VERSION, EXPECTED_LADYBUG_VERSION } from "./ladybug-native";
-import { type LadybugProjectionSource, loadLadybugProjectionSource } from "./ladybug-source";
-import { parseWorkspaceManifest, type WorkspaceManifest } from "./workspace-contract";
-import { buildWorkspaceProjection, type WorkspaceMemberSource, type WorkspaceProjection } from "./workspace-projection";
-
-export interface LoadWorkspaceProjectionOptions {
-  readonly root: string;
-  readonly manifestPath: string;
-  readonly warnings?: WarningCollector;
-  readonly adapterForRoot?: (root: string) => BacklogAdapter | undefined;
-  readonly resolveGitCommit?: (root: string) => string | null;
-  readonly resolveGitRef?: (root: string) => string | null;
-  readonly loadMemberSource?: (member: WorkspaceMemberSourceRequest) => Promise<LadybugProjectionSource>;
-}
-
-export interface WorkspaceMemberSourceRequest {
-  readonly memberId: string;
-  readonly root: string;
-  readonly warnings: WarningCollector;
-}
-
-export interface LoadedWorkspaceProjection {
-  readonly manifestPath: string;
-  readonly manifest: WorkspaceManifest;
-  readonly members: readonly WorkspaceMemberSource[];
-  readonly projection: WorkspaceProjection;
-}
-
-/** Read one explicit manifest and load every declared repository as one complete candidate. */
-export async function loadWorkspaceProjection(
-  options: LoadWorkspaceProjectionOptions,
-): Promise<LoadedWorkspaceProjection> {
-  const manifestPath = resolveWorkspaceManifestPath(options.root, options.manifestPath);
-  const manifest = readWorkspaceManifest(manifestPath);
-  const members: WorkspaceMemberSource[] = [];
-  for (const member of manifest.members) {
-    const root = resolveMemberRoot(manifestPath, member.locator, member.memberId);
-    let actualRef: string | null;
-    try {
-      actualRef = (options.resolveGitRef ?? resolveCurrentGitRef)(root);
-    } catch (cause) {
-      throw memberValidationFailure(member.memberId, cause);
-    }
-    if (member.expectedRef !== null && actualRef !== member.expectedRef) {
-      throw new LoreError(
-        "conflict",
-        `workspace member ${member.memberId} is at ${actualRef ?? "a detached HEAD"}, expected ${member.expectedRef}`,
-        "check out the explicit expected ref or update the manifest before retrying",
-        { memberId: member.memberId, expectedRef: member.expectedRef, actualRef },
-      );
-    }
-    const memberWarnings = new WarningCollector();
-    let source: LadybugProjectionSource;
-    try {
-      source =
-        options.loadMemberSource === undefined
-          ? await loadLadybugProjectionSource({
-              root,
-              ladybugVersion: EXPECTED_LADYBUG_VERSION,
-              ladybugStorageVersion: EXPECTED_LADYBUG_STORAGE_VERSION,
-              adapter: options.adapterForRoot?.(root),
-              resolveGitCommit: options.resolveGitCommit ?? resolveHeadSha,
-              warnings: memberWarnings,
-            })
-          : await options.loadMemberSource({ memberId: member.memberId, root, warnings: memberWarnings });
-    } catch (cause) {
-      throw memberValidationFailure(member.memberId, cause);
-    }
-    for (const warning of memberWarnings.list()) {
-      options.warnings?.add(`[${member.memberId}] ${warning}`);
-    }
-    members.push({ memberId: member.memberId, root, source });
-  }
-  return { manifestPath, manifest, members, projection: buildWorkspaceProjection(manifest, members) };
-}
-
-export function resolveWorkspaceManifestPath(root: string, manifestPath: string): string {
-  if (manifestPath.trim() === "") {
-    throw new LoreError(
-      "usage",
-      "--workspace needs a manifest path",
-      "pass an explicit lore-workspace-manifest/1 JSON file",
-    );
-  }
-  const absolute = resolve(root, manifestPath);
-  const stat = safeLstat(absolute, "workspace manifest");
-  if (!stat.isFile() || stat.isSymbolicLink()) {
-    throw new LoreError("denied", "workspace manifest must be a real regular file, not a symlink");
-  }
-  return realpathSync(absolute);
-}
-
-function readWorkspaceManifest(path: string): WorkspaceManifest {
-  let value: unknown;
-  try {
-    value = JSON.parse(readFileSync(path, "utf8"));
-  } catch (cause) {
-    if (cause instanceof SyntaxError) {
-      throw new LoreError(
-        "validation",
-        `workspace manifest is not valid JSON: ${cause.message}`,
-        "fix the manifest and retry",
-      );
-    }
-    const code = (cause as NodeJS.ErrnoException).code;
-    if (code === "EACCES" || code === "EPERM") {
-      throw new LoreError("denied", "cannot read workspace manifest", "check the explicit manifest permissions");
-    }
-    if (code === "ENOENT") {
-      throw new LoreError("not_found", "cannot find workspace manifest", "check the explicit manifest path");
-    }
-    throw new LoreError("validation", "workspace manifest could not be read", "check the explicit manifest and retry");
-  }
-  try {
-    return parseWorkspaceManifest(value);
-  } catch (cause) {
-    throw new LoreError(
-      "validation",
-      cause instanceof Error ? cause.message : "workspace manifest is invalid",
-      "fix the explicit lore-workspace-manifest/1 file and retry",
-    );
-  }
-}
-
-function resolveMemberRoot(manifestPath: string, locator: string, memberId: string): string {
-  const candidate = isAbsolute(locator) ? resolve(locator) : resolve(dirname(manifestPath), locator);
-  const stat = safeLstat(candidate, `workspace member ${memberId}`);
-  if (!stat.isDirectory() || stat.isSymbolicLink()) {
-    throw new LoreError(
-      "denied",
-      `workspace member ${memberId} must resolve to a real repository directory, not a symlink`,
-      "replace the locator with an explicit real checkout path",
-      { memberId },
-    );
-  }
-  return realpathSync(candidate);
-}
-
-function safeLstat(path: string, label: string): Stats {
-  try {
-    return lstatSync(path) as Stats;
-  } catch (cause) {
-    const code = (cause as NodeJS.ErrnoException).code;
-    if (code === "EACCES" || code === "EPERM") {
-      throw new LoreError("denied", `cannot read ${label}`, "check the explicit path permissions");
-    }
-    throw new LoreError("not_found", `cannot find ${label}`, "check the explicit path exists");
-  }
-}
-
-function memberValidationFailure(memberId: string, cause: unknown): LoreError {
-  const type = cause instanceof LoreError ? cause.type : "validation";
-  return new LoreError(
-    type,
-    `workspace member ${memberId} could not be validated`,
-    "inspect that explicitly selected repository and retry",
-    { memberId },
-  );
-}
-
-function resolveCurrentGitRef(root: string): string | null {
-  const result = Bun.spawnSync(["git", "symbolic-ref", "-q", "HEAD"], { cwd: root, stdout: "pipe", stderr: "pipe" });
-  if (result.exitCode === 0) return result.stdout.toString("utf8").trim();
-  // Prove this is still a valid repository/detached HEAD rather than hiding a Git error.
-  resolveHeadSha(root);
-  return null;
-}