@ebay-dt/bonfire-node 0.2.0-alpha.0 → 0.2.0-alpha.11

package/dist/lifecycle/prototype-path-policy.js

@@ -0,0 +1,429 @@
+import { lstat, readdir, rmdir, unlink } from "node:fs/promises";
+import { isAbsolute, join, relative, resolve, sep } from "node:path";
+import { GitRepositoryError, } from "../git-repository.js";
+const PROTECTED_DIRECTORY_NAMES = new Set([
+    ".git",
+    ".next",
+    ".turbo",
+    ".vercel",
+    "build",
+    "coverage",
+    "dist",
+    "node_modules",
+    "out",
+]);
+const PROTECTED_FILE_NAMES = new Set([
+    ".env",
+    "preferences.json",
+    "id_rsa",
+    "id_ed25519",
+    "id_ecdsa",
+    "id_dsa",
+]);
+const PROTECTED_FILE_EXTENSIONS = new Set([".key", ".pem", ".p12", ".pfx"]);
+const SYMLINK_MODE = "120000";
+const REGULAR_MODE_PREFIX = "100";
+function assertPathspec(pathspec) {
+    if (pathspec.length === 0 ||
+        isAbsolute(pathspec) ||
+        pathspec.startsWith("-") ||
+        pathspec.startsWith(".") ||
+        pathspec.includes("\\") ||
+        pathspec.includes("\0") ||
+        pathspec
+            .split("/")
+            .some((segment) => segment.length === 0 || segment === "..")) {
+        throw new GitRepositoryError("invalid-configuration", "pathspec");
+    }
+}
+function normalizePath(path) {
+    return path.replaceAll("\\", "/").replace(/\/+$/u, "");
+}
+function pathIsWithin(path, parent) {
+    return path === parent || path.startsWith(`${parent}/`);
+}
+function statusPaths(file) {
+    return [file.path, ...(file.from === undefined ? [] : [file.from])].map(normalizePath);
+}
+function pathsOverlap(left, right) {
+    return (left === right || pathIsWithin(left, right) || pathIsWithin(right, left));
+}
+function parseNulPaths(output) {
+    return output
+        .split("\0")
+        .filter(Boolean)
+        .map((entry) => {
+        const tab = entry.indexOf("\t");
+        return normalizePath(tab < 0 ? entry : entry.slice(tab + 1));
+    });
+}
+function parseIndexEntries(output) {
+    return output
+        .split("\0")
+        .filter(Boolean)
+        .flatMap((entry) => {
+        const tab = entry.indexOf("\t");
+        if (tab < 0)
+            return [];
+        const header = entry.slice(0, tab).split(/\s+/u);
+        const mode = header[0];
+        const path = normalizePath(entry.slice(tab + 1));
+        if (mode === undefined || path.length === 0)
+            return [];
+        return [{ mode, path }];
+    });
+}
+function parseTreeEntries(output) {
+    return output
+        .split("\0")
+        .filter(Boolean)
+        .flatMap((entry) => {
+        const tab = entry.indexOf("\t");
+        if (tab < 0)
+            return [];
+        const header = entry.slice(0, tab).split(/\s+/u);
+        const mode = header[0];
+        const path = normalizePath(entry.slice(tab + 1));
+        if (mode === undefined || path.length === 0)
+            return [];
+        return [{ mode, path }];
+    });
+}
+async function gitPaths(repository, args) {
+    const output = await repository.raw([...args]);
+    return parseNulPaths(output);
+}
+async function gitIndexEntries(repository, pathspec) {
+    return parseIndexEntries(await repository.raw(["ls-files", "-s", "-z", "--", pathspec]));
+}
+async function gitTreeEntries(repository, pathspec) {
+    return parseTreeEntries(await repository.raw([
+        "ls-tree",
+        "-r",
+        "-z",
+        "--full-tree",
+        "HEAD",
+        "--",
+        pathspec,
+    ]));
+}
+function basename(path) {
+    const separator = path.lastIndexOf("/");
+    return separator < 0 ? path : path.slice(separator + 1);
+}
+export function isProtectedPrototypePath(path) {
+    const segments = path.split("/");
+    if (segments.some((segment) => PROTECTED_DIRECTORY_NAMES.has(segment))) {
+        return true;
+    }
+    const name = basename(path);
+    if (PROTECTED_FILE_NAMES.has(name))
+        return true;
+    if (name.startsWith(".env") && !name.endsWith(".example"))
+        return true;
+    if (name.endsWith(".local.json"))
+        return true;
+    const extension = name.slice(name.lastIndexOf(".")).toLowerCase();
+    return PROTECTED_FILE_EXTENSIONS.has(extension);
+}
+export function isRegularPrototypeMode(mode) {
+    return mode !== undefined && mode.startsWith(REGULAR_MODE_PREFIX);
+}
+const isProtectedPath = isProtectedPrototypePath;
+const isRegularMode = isRegularPrototypeMode;
+async function walkFilesystem(root, pathspec) {
+    const entries = [];
+    const absoluteRoot = resolve(root, ...pathspec.split("/"));
+    const rootRelative = relative(root, absoluteRoot).split(sep).join("/");
+    const visit = async (absolutePath, relativePath) => {
+        let stats;
+        try {
+            stats = await lstat(absolutePath);
+        }
+        catch (error) {
+            if (error &&
+                typeof error === "object" &&
+                "code" in error &&
+                error.code === "ENOENT") {
+                return;
+            }
+            throw error;
+        }
+        if (stats.isSymbolicLink()) {
+            entries.push({ path: relativePath, kind: "symlink" });
+            return;
+        }
+        if (stats.isDirectory()) {
+            entries.push({ path: relativePath, kind: "directory" });
+            if (relativePath !== rootRelative && isProtectedPath(relativePath))
+                return;
+            for (const entry of await readdir(absolutePath)) {
+                const childPath = `${relativePath}/${entry}`;
+                await visit(join(absolutePath, entry), childPath);
+            }
+            return;
+        }
+        entries.push({
+            path: relativePath,
+            kind: stats.isFile() ? "file" : "special",
+        });
+    };
+    await visit(absoluteRoot, rootRelative);
+    return entries;
+}
+function throwProtected(paths) {
+    if (paths.length > 0) {
+        throw new GitRepositoryError("conflict", "protected-prototype-path");
+    }
+}
+function changedPaths(files, eligiblePaths) {
+    const status = files.flatMap(statusPaths);
+    return eligiblePaths.filter((path) => status.some((statusPath) => pathsOverlap(path, statusPath)));
+}
+export async function inspectPrototypePath(repository, pathspec) {
+    assertPathspec(pathspec);
+    const normalizedPath = normalizePath(pathspec);
+    const [status, indexEntries, treeEntries, untrackedPaths, filesystem] = await Promise.all([
+        repository.status([normalizedPath]),
+        gitIndexEntries(repository, normalizedPath),
+        gitTreeEntries(repository, normalizedPath),
+        gitPaths(repository, [
+            "ls-files",
+            "--others",
+            "--exclude-standard",
+            "-z",
+            "--",
+            normalizedPath,
+        ]),
+        walkFilesystem(repository.repositoryRoot, normalizedPath),
+    ]);
+    const indexModes = new Map(indexEntries.map((entry) => [entry.path, entry.mode]));
+    const treeModes = new Map(treeEntries.map((entry) => [entry.path, entry.mode]));
+    const filesystemEntries = new Map(filesystem.map((entry) => [entry.path, entry]));
+    const trackedPaths = new Set([...treeModes.keys(), ...indexModes.keys()]);
+    const untracked = new Set(untrackedPaths);
+    const eligible = new Set();
+    const trackedEligible = new Set();
+    const newPaths = new Set();
+    const stagedPaths = new Set();
+    const existing = new Set();
+    const protectedPaths = new Set();
+    const trackedProtectedPaths = new Set();
+    const classifyTracked = (path) => {
+        const indexMode = indexModes.get(path);
+        const treeMode = treeModes.get(path);
+        if (isProtectedPath(path) ||
+            (indexMode !== undefined && !isRegularMode(indexMode)) ||
+            (treeMode !== undefined && !isRegularMode(treeMode))) {
+            protectedPaths.add(path);
+            trackedProtectedPaths.add(path);
+            return;
+        }
+        const filesystemEntry = filesystemEntries.get(path);
+        if (filesystemEntry !== undefined && filesystemEntry.kind !== "file") {
+            protectedPaths.add(path);
+            trackedProtectedPaths.add(path);
+            return;
+        }
+        eligible.add(path);
+        trackedEligible.add(path);
+    };
+    for (const path of treeModes.keys())
+        classifyTracked(path);
+    for (const path of indexModes.keys()) {
+        if (treeModes.has(path)) {
+            classifyTracked(path);
+        }
+        else if (isProtectedPath(path) ||
+            !isRegularMode(indexModes.get(path)) ||
+            (filesystemEntries.get(path) !== undefined &&
+                filesystemEntries.get(path)?.kind !== "file")) {
+            protectedPaths.add(path);
+            trackedProtectedPaths.add(path);
+        }
+        else {
+            eligible.add(path);
+            newPaths.add(path);
+            stagedPaths.add(path);
+        }
+    }
+    for (const entry of filesystem) {
+        const path = entry.path;
+        if (entry.kind === "directory") {
+            if (path !== normalizedPath && isProtectedPath(path)) {
+                protectedPaths.add(path);
+            }
+            continue;
+        }
+        if (entry.kind !== "file") {
+            protectedPaths.add(path);
+            if (trackedPaths.has(path))
+                trackedProtectedPaths.add(path);
+            continue;
+        }
+        if (trackedPaths.has(path)) {
+            if (isProtectedPath(path)) {
+                protectedPaths.add(path);
+                trackedProtectedPaths.add(path);
+            }
+            else if (!isRegularMode(indexModes.get(path) ?? treeModes.get(path)) ||
+                indexModes.get(path) === SYMLINK_MODE ||
+                treeModes.get(path) === SYMLINK_MODE) {
+                protectedPaths.add(path);
+                trackedProtectedPaths.add(path);
+            }
+            else {
+                eligible.add(path);
+                existing.add(path);
+            }
+            continue;
+        }
+        // Files absent from --exclude-standard are ignored content. Leave them
+        // alone without making Delete fail on them.
+        if (!untracked.has(path)) {
+            if (isProtectedPath(path))
+                protectedPaths.add(path);
+            continue;
+        }
+        if (isProtectedPath(path)) {
+            protectedPaths.add(path);
+        }
+        else {
+            eligible.add(path);
+            newPaths.add(path);
+            existing.add(path);
+        }
+    }
+    const eligiblePaths = [...eligible].sort();
+    return {
+        eligiblePaths,
+        trackedEligiblePaths: [...trackedEligible].sort(),
+        changedEligiblePaths: changedPaths(status.files, eligiblePaths),
+        newEligiblePaths: [...newPaths].sort(),
+        stagedEligiblePaths: [...stagedPaths].sort(),
+        existingEligiblePaths: [...existing].sort(),
+        protectedPaths: [...protectedPaths].sort(),
+        trackedProtectedPaths: [...trackedProtectedPaths].sort(),
+    };
+}
+export async function commitPrototypePath(repository, pathspec, message) {
+    const plan = await inspectPrototypePath(repository, pathspec);
+    throwProtected(plan.trackedProtectedPaths);
+    if (plan.changedEligiblePaths.length === 0)
+        return null;
+    await repository.add(plan.changedEligiblePaths);
+    return repository.commit(message, plan.changedEligiblePaths);
+}
+async function assertSafeParents(repository, absolutePath) {
+    const relativePath = relative(repository.repositoryRoot, absolutePath);
+    const segments = relativePath.split(sep);
+    let current = repository.repositoryRoot;
+    for (const segment of segments.slice(0, -1)) {
+        current = join(current, segment);
+        const stats = await lstat(current);
+        if (stats.isSymbolicLink() || !stats.isDirectory()) {
+            throw new GitRepositoryError("conflict", "prototype-path-changed");
+        }
+    }
+}
+async function removeFiles(repository, paths) {
+    for (const path of paths) {
+        const absolutePath = resolve(repository.repositoryRoot, ...path.split("/"));
+        await assertSafeParents(repository, absolutePath);
+        let stats;
+        try {
+            stats = await lstat(absolutePath);
+        }
+        catch (error) {
+            if (error &&
+                typeof error === "object" &&
+                "code" in error &&
+                error.code === "ENOENT") {
+                continue;
+            }
+            throw error;
+        }
+        if (!stats.isFile() || stats.isSymbolicLink()) {
+            throw new GitRepositoryError("conflict", "prototype-path-changed");
+        }
+        await unlink(absolutePath);
+    }
+}
+async function removeEmptyDirectories(repository, pathspec) {
+    const root = resolve(repository.repositoryRoot, ...pathspec.split("/"));
+    const directories = [];
+    const visit = async (absolutePath) => {
+        let stats;
+        try {
+            stats = await lstat(absolutePath);
+        }
+        catch {
+            return;
+        }
+        if (stats.isSymbolicLink() || !stats.isDirectory())
+            return;
+        const relativePath = relative(repository.repositoryRoot, absolutePath)
+            .split(sep)
+            .join("/");
+        if (relativePath !== pathspec && isProtectedPath(relativePath))
+            return;
+        for (const entry of await readdir(absolutePath)) {
+            await visit(join(absolutePath, entry));
+        }
+        directories.push(absolutePath);
+    };
+    await visit(root);
+    for (const directory of directories) {
+        try {
+            await assertSafeParents(repository, directory);
+            await rmdir(directory);
+        }
+        catch {
+            // Non-empty directories contain protected or unrelated content.
+        }
+    }
+}
+export async function discardPrototypePath(repository, pathspec) {
+    const plan = await inspectPrototypePath(repository, pathspec);
+    if (plan.changedEligiblePaths.length === 0 &&
+        plan.newEligiblePaths.length === 0) {
+        return;
+    }
+    const trackedChanged = plan.changedEligiblePaths.filter((path) => plan.trackedEligiblePaths.includes(path));
+    const stagedAdditions = plan.stagedEligiblePaths;
+    if (stagedAdditions.length > 0) {
+        await repository.raw(["reset", "HEAD", "--", ...stagedAdditions]);
+    }
+    if (trackedChanged.length > 0) {
+        await repository.raw(["reset", "HEAD", "--", ...trackedChanged]);
+        await repository.restore(trackedChanged);
+    }
+    await removeFiles(repository, plan.newEligiblePaths);
+    await removeEmptyDirectories(repository, pathspec);
+}
+export async function deletePrototypePath(repository, pathspec, message) {
+    const before = await inspectPrototypePath(repository, pathspec);
+    // Untracked excluded files can safely remain in place while ordinary
+    // prototype content is deleted. Tracked exclusions still block because
+    // staging their surrounding type/deletion could silently alter protected
+    // repository state.
+    throwProtected(before.trackedProtectedPaths);
+    if (before.stagedEligiblePaths.length > 0) {
+        await repository.raw([
+            "reset",
+            "HEAD",
+            "--",
+            ...before.stagedEligiblePaths,
+        ]);
+    }
+    await removeFiles(repository, before.existingEligiblePaths);
+    await removeEmptyDirectories(repository, pathspec);
+    const after = await inspectPrototypePath(repository, pathspec);
+    throwProtected(after.trackedProtectedPaths);
+    if (message === undefined || after.trackedEligiblePaths.length === 0) {
+        return null;
+    }
+    await repository.add(after.trackedEligiblePaths);
+    return repository.commit(message, after.trackedEligiblePaths);
+}
+//# sourceMappingURL=prototype-path-policy.js.map

package/dist/lifecycle/prototype-path-policy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prototype-path-policy.js","sourceRoot":"","sources":["../../src/lifecycle/prototype-path-policy.ts"],"names":[],"mappings":"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","sourcesContent":["import { lstat, readdir, rmdir, unlink } from \"node:fs/promises\";\nimport { isAbsolute, join, relative, resolve, sep } from \"node:path\";\nimport {\n  GitRepositoryError,\n  type GitRepository,\n  type GitStatusFile,\n} from \"../git-repository.js\";\n\nconst PROTECTED_DIRECTORY_NAMES = new Set([\n  \".git\",\n  \".next\",\n  \".turbo\",\n  \".vercel\",\n  \"build\",\n  \"coverage\",\n  \"dist\",\n  \"node_modules\",\n  \"out\",\n]);\n\nconst PROTECTED_FILE_NAMES = new Set([\n  \".env\",\n  \"preferences.json\",\n  \"id_rsa\",\n  \"id_ed25519\",\n  \"id_ecdsa\",\n  \"id_dsa\",\n]);\n\nconst PROTECTED_FILE_EXTENSIONS = new Set([\".key\", \".pem\", \".p12\", \".pfx\"]);\n\nconst SYMLINK_MODE = \"120000\";\nconst REGULAR_MODE_PREFIX = \"100\";\n\ntype GitIndexEntry = {\n  path: string;\n  mode: string;\n};\n\ntype FilesystemEntry = {\n  path: string;\n  kind: \"directory\" | \"file\" | \"symlink\" | \"special\";\n};\n\nexport type PrototypePathPlan = {\n  eligiblePaths: readonly string[];\n  trackedEligiblePaths: readonly string[];\n  changedEligiblePaths: readonly string[];\n  newEligiblePaths: readonly string[];\n  stagedEligiblePaths: readonly string[];\n  existingEligiblePaths: readonly string[];\n  protectedPaths: readonly string[];\n  trackedProtectedPaths: readonly string[];\n};\n\nfunction assertPathspec(pathspec: string) {\n  if (\n    pathspec.length === 0 ||\n    isAbsolute(pathspec) ||\n    pathspec.startsWith(\"-\") ||\n    pathspec.startsWith(\".\") ||\n    pathspec.includes(\"\\\\\") ||\n    pathspec.includes(\"\\0\") ||\n    pathspec\n      .split(\"/\")\n      .some((segment) => segment.length === 0 || segment === \"..\")\n  ) {\n    throw new GitRepositoryError(\"invalid-configuration\", \"pathspec\");\n  }\n}\n\nfunction normalizePath(path: string) {\n  return path.replaceAll(\"\\\\\", \"/\").replace(/\\/+$/u, \"\");\n}\n\nfunction pathIsWithin(path: string, parent: string) {\n  return path === parent || path.startsWith(`${parent}/`);\n}\n\nfunction statusPaths(file: GitStatusFile) {\n  return [file.path, ...(file.from === undefined ? [] : [file.from])].map(\n    normalizePath,\n  );\n}\n\nfunction pathsOverlap(left: string, right: string) {\n  return (\n    left === right || pathIsWithin(left, right) || pathIsWithin(right, left)\n  );\n}\n\nfunction parseNulPaths(output: string) {\n  return output\n    .split(\"\\0\")\n    .filter(Boolean)\n    .map((entry) => {\n      const tab = entry.indexOf(\"\\t\");\n      return normalizePath(tab < 0 ? entry : entry.slice(tab + 1));\n    });\n}\n\nfunction parseIndexEntries(output: string): GitIndexEntry[] {\n  return output\n    .split(\"\\0\")\n    .filter(Boolean)\n    .flatMap((entry) => {\n      const tab = entry.indexOf(\"\\t\");\n      if (tab < 0) return [];\n      const header = entry.slice(0, tab).split(/\\s+/u);\n      const mode = header[0];\n      const path = normalizePath(entry.slice(tab + 1));\n      if (mode === undefined || path.length === 0) return [];\n      return [{ mode, path }];\n    });\n}\n\nfunction parseTreeEntries(output: string): GitIndexEntry[] {\n  return output\n    .split(\"\\0\")\n    .filter(Boolean)\n    .flatMap((entry) => {\n      const tab = entry.indexOf(\"\\t\");\n      if (tab < 0) return [];\n      const header = entry.slice(0, tab).split(/\\s+/u);\n      const mode = header[0];\n      const path = normalizePath(entry.slice(tab + 1));\n      if (mode === undefined || path.length === 0) return [];\n      return [{ mode, path }];\n    });\n}\n\nasync function gitPaths(\n  repository: GitRepository,\n  args: readonly string[],\n): Promise<string[]> {\n  const output = await repository.raw([...args]);\n  return parseNulPaths(output);\n}\n\nasync function gitIndexEntries(\n  repository: GitRepository,\n  pathspec: string,\n): Promise<GitIndexEntry[]> {\n  return parseIndexEntries(\n    await repository.raw([\"ls-files\", \"-s\", \"-z\", \"--\", pathspec]),\n  );\n}\n\nasync function gitTreeEntries(\n  repository: GitRepository,\n  pathspec: string,\n): Promise<GitIndexEntry[]> {\n  return parseTreeEntries(\n    await repository.raw([\n      \"ls-tree\",\n      \"-r\",\n      \"-z\",\n      \"--full-tree\",\n      \"HEAD\",\n      \"--\",\n      pathspec,\n    ]),\n  );\n}\n\nfunction basename(path: string) {\n  const separator = path.lastIndexOf(\"/\");\n  return separator < 0 ? path : path.slice(separator + 1);\n}\n\nexport function isProtectedPrototypePath(path: string) {\n  const segments = path.split(\"/\");\n  if (segments.some((segment) => PROTECTED_DIRECTORY_NAMES.has(segment))) {\n    return true;\n  }\n\n  const name = basename(path);\n  if (PROTECTED_FILE_NAMES.has(name)) return true;\n  if (name.startsWith(\".env\") && !name.endsWith(\".example\")) return true;\n  if (name.endsWith(\".local.json\")) return true;\n  const extension = name.slice(name.lastIndexOf(\".\")).toLowerCase();\n  return PROTECTED_FILE_EXTENSIONS.has(extension);\n}\n\nexport function isRegularPrototypeMode(mode: string | undefined) {\n  return mode !== undefined && mode.startsWith(REGULAR_MODE_PREFIX);\n}\n\nconst isProtectedPath = isProtectedPrototypePath;\nconst isRegularMode = isRegularPrototypeMode;\n\nasync function walkFilesystem(\n  root: string,\n  pathspec: string,\n): Promise<FilesystemEntry[]> {\n  const entries: FilesystemEntry[] = [];\n  const absoluteRoot = resolve(root, ...pathspec.split(\"/\"));\n  const rootRelative = relative(root, absoluteRoot).split(sep).join(\"/\");\n  const visit = async (absolutePath: string, relativePath: string) => {\n    let stats;\n    try {\n      stats = await lstat(absolutePath);\n    } catch (error) {\n      if (\n        error &&\n        typeof error === \"object\" &&\n        \"code\" in error &&\n        error.code === \"ENOENT\"\n      ) {\n        return;\n      }\n      throw error;\n    }\n\n    if (stats.isSymbolicLink()) {\n      entries.push({ path: relativePath, kind: \"symlink\" });\n      return;\n    }\n    if (stats.isDirectory()) {\n      entries.push({ path: relativePath, kind: \"directory\" });\n      if (relativePath !== rootRelative && isProtectedPath(relativePath))\n        return;\n      for (const entry of await readdir(absolutePath)) {\n        const childPath = `${relativePath}/${entry}`;\n        await visit(join(absolutePath, entry), childPath);\n      }\n      return;\n    }\n    entries.push({\n      path: relativePath,\n      kind: stats.isFile() ? \"file\" : \"special\",\n    });\n  };\n\n  await visit(absoluteRoot, rootRelative);\n  return entries;\n}\n\nfunction throwProtected(paths: readonly string[]) {\n  if (paths.length > 0) {\n    throw new GitRepositoryError(\"conflict\", \"protected-prototype-path\");\n  }\n}\n\nfunction changedPaths(\n  files: readonly GitStatusFile[],\n  eligiblePaths: readonly string[],\n) {\n  const status = files.flatMap(statusPaths);\n  return eligiblePaths.filter((path) =>\n    status.some((statusPath) => pathsOverlap(path, statusPath)),\n  );\n}\n\nexport async function inspectPrototypePath(\n  repository: GitRepository,\n  pathspec: string,\n): Promise<PrototypePathPlan> {\n  assertPathspec(pathspec);\n  const normalizedPath = normalizePath(pathspec);\n  const [status, indexEntries, treeEntries, untrackedPaths, filesystem] =\n    await Promise.all([\n      repository.status([normalizedPath]),\n      gitIndexEntries(repository, normalizedPath),\n      gitTreeEntries(repository, normalizedPath),\n      gitPaths(repository, [\n        \"ls-files\",\n        \"--others\",\n        \"--exclude-standard\",\n        \"-z\",\n        \"--\",\n        normalizedPath,\n      ]),\n      walkFilesystem(repository.repositoryRoot, normalizedPath),\n    ]);\n\n  const indexModes = new Map(\n    indexEntries.map((entry) => [entry.path, entry.mode]),\n  );\n  const treeModes = new Map(\n    treeEntries.map((entry) => [entry.path, entry.mode]),\n  );\n  const filesystemEntries = new Map(\n    filesystem.map((entry) => [entry.path, entry]),\n  );\n  const trackedPaths = new Set([...treeModes.keys(), ...indexModes.keys()]);\n  const untracked = new Set(untrackedPaths);\n  const eligible = new Set<string>();\n  const trackedEligible = new Set<string>();\n  const newPaths = new Set<string>();\n  const stagedPaths = new Set<string>();\n  const existing = new Set<string>();\n  const protectedPaths = new Set<string>();\n  const trackedProtectedPaths = new Set<string>();\n\n  const classifyTracked = (path: string) => {\n    const indexMode = indexModes.get(path);\n    const treeMode = treeModes.get(path);\n    if (\n      isProtectedPath(path) ||\n      (indexMode !== undefined && !isRegularMode(indexMode)) ||\n      (treeMode !== undefined && !isRegularMode(treeMode))\n    ) {\n      protectedPaths.add(path);\n      trackedProtectedPaths.add(path);\n      return;\n    }\n    const filesystemEntry = filesystemEntries.get(path);\n    if (filesystemEntry !== undefined && filesystemEntry.kind !== \"file\") {\n      protectedPaths.add(path);\n      trackedProtectedPaths.add(path);\n      return;\n    }\n    eligible.add(path);\n    trackedEligible.add(path);\n  };\n\n  for (const path of treeModes.keys()) classifyTracked(path);\n  for (const path of indexModes.keys()) {\n    if (treeModes.has(path)) {\n      classifyTracked(path);\n    } else if (\n      isProtectedPath(path) ||\n      !isRegularMode(indexModes.get(path)) ||\n      (filesystemEntries.get(path) !== undefined &&\n        filesystemEntries.get(path)?.kind !== \"file\")\n    ) {\n      protectedPaths.add(path);\n      trackedProtectedPaths.add(path);\n    } else {\n      eligible.add(path);\n      newPaths.add(path);\n      stagedPaths.add(path);\n    }\n  }\n\n  for (const entry of filesystem) {\n    const path = entry.path;\n    if (entry.kind === \"directory\") {\n      if (path !== normalizedPath && isProtectedPath(path)) {\n        protectedPaths.add(path);\n      }\n      continue;\n    }\n    if (entry.kind !== \"file\") {\n      protectedPaths.add(path);\n      if (trackedPaths.has(path)) trackedProtectedPaths.add(path);\n      continue;\n    }\n\n    if (trackedPaths.has(path)) {\n      if (isProtectedPath(path)) {\n        protectedPaths.add(path);\n        trackedProtectedPaths.add(path);\n      } else if (\n        !isRegularMode(indexModes.get(path) ?? treeModes.get(path)) ||\n        indexModes.get(path) === SYMLINK_MODE ||\n        treeModes.get(path) === SYMLINK_MODE\n      ) {\n        protectedPaths.add(path);\n        trackedProtectedPaths.add(path);\n      } else {\n        eligible.add(path);\n        existing.add(path);\n      }\n      continue;\n    }\n\n    // Files absent from --exclude-standard are ignored content. Leave them\n    // alone without making Delete fail on them.\n    if (!untracked.has(path)) {\n      if (isProtectedPath(path)) protectedPaths.add(path);\n      continue;\n    }\n    if (isProtectedPath(path)) {\n      protectedPaths.add(path);\n    } else {\n      eligible.add(path);\n      newPaths.add(path);\n      existing.add(path);\n    }\n  }\n\n  const eligiblePaths = [...eligible].sort();\n  return {\n    eligiblePaths,\n    trackedEligiblePaths: [...trackedEligible].sort(),\n    changedEligiblePaths: changedPaths(status.files, eligiblePaths),\n    newEligiblePaths: [...newPaths].sort(),\n    stagedEligiblePaths: [...stagedPaths].sort(),\n    existingEligiblePaths: [...existing].sort(),\n    protectedPaths: [...protectedPaths].sort(),\n    trackedProtectedPaths: [...trackedProtectedPaths].sort(),\n  };\n}\n\nexport async function commitPrototypePath(\n  repository: GitRepository,\n  pathspec: string,\n  message: string,\n) {\n  const plan = await inspectPrototypePath(repository, pathspec);\n  throwProtected(plan.trackedProtectedPaths);\n  if (plan.changedEligiblePaths.length === 0) return null;\n  await repository.add(plan.changedEligiblePaths);\n  return repository.commit(message, plan.changedEligiblePaths);\n}\n\nasync function assertSafeParents(\n  repository: GitRepository,\n  absolutePath: string,\n) {\n  const relativePath = relative(repository.repositoryRoot, absolutePath);\n  const segments = relativePath.split(sep);\n  let current = repository.repositoryRoot;\n  for (const segment of segments.slice(0, -1)) {\n    current = join(current, segment);\n    const stats = await lstat(current);\n    if (stats.isSymbolicLink() || !stats.isDirectory()) {\n      throw new GitRepositoryError(\"conflict\", \"prototype-path-changed\");\n    }\n  }\n}\n\nasync function removeFiles(\n  repository: GitRepository,\n  paths: readonly string[],\n) {\n  for (const path of paths) {\n    const absolutePath = resolve(repository.repositoryRoot, ...path.split(\"/\"));\n    await assertSafeParents(repository, absolutePath);\n    let stats;\n    try {\n      stats = await lstat(absolutePath);\n    } catch (error) {\n      if (\n        error &&\n        typeof error === \"object\" &&\n        \"code\" in error &&\n        error.code === \"ENOENT\"\n      ) {\n        continue;\n      }\n      throw error;\n    }\n    if (!stats.isFile() || stats.isSymbolicLink()) {\n      throw new GitRepositoryError(\"conflict\", \"prototype-path-changed\");\n    }\n    await unlink(absolutePath);\n  }\n}\n\nasync function removeEmptyDirectories(\n  repository: GitRepository,\n  pathspec: string,\n) {\n  const root = resolve(repository.repositoryRoot, ...pathspec.split(\"/\"));\n  const directories: string[] = [];\n  const visit = async (absolutePath: string) => {\n    let stats;\n    try {\n      stats = await lstat(absolutePath);\n    } catch {\n      return;\n    }\n    if (stats.isSymbolicLink() || !stats.isDirectory()) return;\n    const relativePath = relative(repository.repositoryRoot, absolutePath)\n      .split(sep)\n      .join(\"/\");\n    if (relativePath !== pathspec && isProtectedPath(relativePath)) return;\n    for (const entry of await readdir(absolutePath)) {\n      await visit(join(absolutePath, entry));\n    }\n    directories.push(absolutePath);\n  };\n  await visit(root);\n  for (const directory of directories) {\n    try {\n      await assertSafeParents(repository, directory);\n      await rmdir(directory);\n    } catch {\n      // Non-empty directories contain protected or unrelated content.\n    }\n  }\n}\n\nexport async function discardPrototypePath(\n  repository: GitRepository,\n  pathspec: string,\n) {\n  const plan = await inspectPrototypePath(repository, pathspec);\n  if (\n    plan.changedEligiblePaths.length === 0 &&\n    plan.newEligiblePaths.length === 0\n  ) {\n    return;\n  }\n\n  const trackedChanged = plan.changedEligiblePaths.filter((path) =>\n    plan.trackedEligiblePaths.includes(path),\n  );\n  const stagedAdditions = plan.stagedEligiblePaths;\n  if (stagedAdditions.length > 0) {\n    await repository.raw([\"reset\", \"HEAD\", \"--\", ...stagedAdditions]);\n  }\n  if (trackedChanged.length > 0) {\n    await repository.raw([\"reset\", \"HEAD\", \"--\", ...trackedChanged]);\n    await repository.restore(trackedChanged);\n  }\n  await removeFiles(repository, plan.newEligiblePaths);\n  await removeEmptyDirectories(repository, pathspec);\n}\n\nexport async function deletePrototypePath(\n  repository: GitRepository,\n  pathspec: string,\n  message?: string,\n) {\n  const before = await inspectPrototypePath(repository, pathspec);\n  // Untracked excluded files can safely remain in place while ordinary\n  // prototype content is deleted. Tracked exclusions still block because\n  // staging their surrounding type/deletion could silently alter protected\n  // repository state.\n  throwProtected(before.trackedProtectedPaths);\n  if (before.stagedEligiblePaths.length > 0) {\n    await repository.raw([\n      \"reset\",\n      \"HEAD\",\n      \"--\",\n      ...before.stagedEligiblePaths,\n    ]);\n  }\n  await removeFiles(repository, before.existingEligiblePaths);\n  await removeEmptyDirectories(repository, pathspec);\n\n  const after = await inspectPrototypePath(repository, pathspec);\n  throwProtected(after.trackedProtectedPaths);\n  if (message === undefined || after.trackedEligiblePaths.length === 0) {\n    return null;\n  }\n  await repository.add(after.trackedEligiblePaths);\n  return repository.commit(message, after.trackedEligiblePaths);\n}\n"]}

package/dist/lifecycle/repository-summary.d.ts

@@ -1,4 +1,4 @@
-import { type BonfireIdentity, type GitMode, type RepositorySummary } from "@ebay-dt/bonfire-core";
+import { type BonfireIdentity, type GitMode, type BranchPreparationAttention, type RepositorySummary } from "@ebay-dt/bonfire-core";
 import type { PrototypeCatalogLike } from "../prototype-catalog.js";
 import { type GitRepository } from "../git-repository.js";
 export type RepositorySummaryOptions = {
@@ -10,8 +10,14 @@ export type RepositorySummaryOptions = {
     mode: GitMode;
     remote: string;
     primaryBranch: string;
+    /** True when the running server must restart to load updated dependencies. */
+    restartRequired?: boolean;
     /** Fetch remote-tracking refs before comparing managed update state. */
     refresh?: boolean;
+    /** Latest non-ready preparation attempt retained across clean reads. */
+    preparationAttention?: BranchPreparationAttention;
+    /** Protected dependency-installation marker, if present. */
+    preparationPending?: boolean;
 };
 export declare function getRepositorySummary(options: RepositorySummaryOptions): Promise<RepositorySummary>;
 //# sourceMappingURL=repository-summary.d.ts.map

package/dist/lifecycle/repository-summary.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"repository-summary.d.ts","sourceRoot":"","sources":["../../src/lifecycle/repository-summary.ts"],"names":[],"mappings":"AACA,OAAO,EAGL,KAAK,eAAe,EACpB,KAAK,OAAO,EAOZ,KAAK,iBAAiB,EACvB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AACpE,OAAO,EACL,KAAK,aAAa,EAEnB,MAAM,sBAAsB,CAAC;AAG9B,MAAM,MAAM,wBAAwB,GAAG;IACrC,UAAU,EAAE,aAAa,CAAC;IAC1B,OAAO,EAAE,oBAAoB,CAAC;IAC9B,cAAc,EAAE,MAAM,CAAC;IACvB,aAAa,EAAE,MAAM,CAAC;IACtB,QAAQ,EAAE,eAAe,CAAC;IAC1B,IAAI,EAAE,OAAO,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,aAAa,EAAE,MAAM,CAAC;IACtB,wEAAwE;IACxE,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB,CAAC;AAoHF,wBAAsB,oBAAoB,CACxC,OAAO,EAAE,wBAAwB,GAChC,OAAO,CAAC,iBAAiB,CAAC,CAsI5B","sourcesContent":["import { relative } from \"node:path\";\nimport {\n  getGitManagementCapabilities,\n  parseRepositoryRelativePath,\n  type BonfireIdentity,\n  type GitMode,\n  type PrototypeRef,\n  type PrototypeSummary,\n  type RepositoryAttentionCode,\n  type RepositoryChange,\n  type RepositoryChangeScope,\n  type RepositoryChangeStatus,\n  type RepositorySummary,\n} from \"@ebay-dt/bonfire-core\";\nimport type { PrototypeCatalogLike } from \"../prototype-catalog.js\";\nimport {\n  type GitRepository,\n  type GitStatusFile,\n} from \"../git-repository.js\";\nimport { hasUnresolvedRepositoryOperation } from \"./repository-synchronization.js\";\n\nexport type RepositorySummaryOptions = {\n  repository: GitRepository;\n  catalog: PrototypeCatalogLike;\n  repositoryRoot: string;\n  prototypeRoot: string;\n  identity: BonfireIdentity;\n  mode: GitMode;\n  remote: string;\n  primaryBranch: string;\n  /** Fetch remote-tracking refs before comparing managed update state. */\n  refresh?: boolean;\n};\n\ntype SummaryPathContext = {\n  scope: RepositoryChangeScope;\n  prototype: PrototypeRef | undefined;\n};\n\nfunction normalizePath(value: string) {\n  return value.replaceAll(\"\\\\\", \"/\").replace(/^\\.\\//u, \"\");\n}\n\nfunction pathPrefix(repositoryRoot: string, prototypeRoot: string) {\n  const value = normalizePath(relative(repositoryRoot, prototypeRoot));\n  return value === \".\" ? \"\" : value.replace(/\\/+$/u, \"\");\n}\n\nfunction summaryKey(ref: PrototypeRef) {\n  return `${ref.login}/${ref.slug}`;\n}\n\nfunction contextForPath(\n  value: string,\n  prefix: string,\n  summaries: ReadonlyMap<string, PrototypeSummary>,\n  identity: BonfireIdentity,\n): SummaryPathContext {\n  const path = normalizePath(value);\n  const rest = prefix === \"\" ? path : path.startsWith(`${prefix}/`) ? path.slice(prefix.length + 1) : null;\n  if (rest === null) return { scope: \"out-of-scope\", prototype: undefined };\n\n  const segments = rest.split(\"/\");\n  const login = segments[0];\n  const slug = segments[1];\n  if (login === undefined || slug === undefined) {\n    return { scope: \"unknown\", prototype: undefined };\n  }\n\n  const ref = { login, slug } satisfies PrototypeRef;\n  const summary = summaries.get(summaryKey(ref));\n  if (summary === undefined) return { scope: \"unknown\", prototype: undefined };\n\n  return {\n    scope: login === identity.login ? \"owned-prototype\" : \"other-prototype\",\n    prototype: ref,\n  };\n}\n\nfunction safePath(value: string) {\n  try {\n    return parseRepositoryRelativePath(normalizePath(value));\n  } catch {\n    return null;\n  }\n}\n\nfunction addChange(\n  changes: Map<string, RepositoryChange>,\n  path: string,\n  status: RepositoryChangeStatus,\n  context: SummaryPathContext,\n) {\n  const safe = safePath(path);\n  if (safe === null) return;\n  const key = `${status}:${safe}`;\n  changes.set(key, {\n    path: safe,\n    status,\n    scope: context.scope,\n    ...(context.prototype === undefined ? {} : { prototype: context.prototype }),\n  });\n}\n\nfunction statusPaths(file: GitStatusFile) {\n  return [file.path, ...(file.from === undefined ? [] : [file.from])];\n}\n\nasync function diffPaths(repository: GitRepository, range: string) {\n  const output = await repository.raw([\"diff\", \"--name-only\", \"-z\", range]);\n  return output.split(\"\\0\").filter((path) => path.length > 0);\n}\n\nasync function refRelation(repository: GitRepository, left: string, right: string) {\n  const output = await repository.raw([\n    \"rev-list\",\n    \"--left-right\",\n    \"--count\",\n    `${left}...${right}`,\n  ]);\n  const values = output.trim().split(/\\s+/u).map(Number);\n  if (\n    values.length !== 2 ||\n    values.some((value) => !Number.isSafeInteger(value) || value < 0)\n  ) {\n    throw new Error(\"Malformed Git ref relation\");\n  }\n  return { ahead: values[0]!, behind: values[1]! };\n}\n\nfunction addDiffChanges(\n  changes: Map<string, RepositoryChange>,\n  paths: readonly string[],\n  status: RepositoryChangeStatus,\n  prefix: string,\n  summaries: ReadonlyMap<string, PrototypeSummary>,\n  identity: BonfireIdentity,\n) {\n  for (const path of paths) {\n    addChange(\n      changes,\n      path,\n      status,\n      contextForPath(path, prefix, summaries, identity),\n    );\n  }\n}\n\nexport async function getRepositorySummary(\n  options: RepositorySummaryOptions,\n): Promise<RepositorySummary> {\n  const summaries = new Map(\n    (await options.catalog.scan()).map((summary) => [\n      summaryKey(summary.ref),\n      summary,\n    ]),\n  );\n  const prefix = pathPrefix(options.repositoryRoot, options.prototypeRoot);\n  const changes = new Map<string, RepositoryChange>();\n  const attention = new Set<RepositoryAttentionCode>();\n  const status = await options.repository.status();\n  const currentBranch = await options.repository.currentBranch();\n  const unresolved = await hasUnresolvedRepositoryOperation(options.repository);\n  const detached = currentBranch === \"HEAD\" || currentBranch.length === 0;\n  const wrongBranch = !detached && currentBranch !== options.identity.login;\n\n  for (const file of status.files) {\n    const fileStatus =\n      file.index.includes(\"U\") || file.workingDirectory.includes(\"U\")\n        ? \"unresolved\"\n        : \"uncommitted\";\n    for (const path of statusPaths(file)) {\n      addChange(\n        changes,\n        path,\n        fileStatus,\n        contextForPath(path, prefix, summaries, options.identity),\n      );\n    }\n  }\n\n  if (status.files.length > 0) attention.add(\"dirty-worktree\");\n  if (unresolved) attention.add(\"unresolved-operation\");\n  if (detached) attention.add(\"detached-head\");\n  if (wrongBranch) attention.add(\"wrong-branch\");\n\n  const remotes = await options.repository.remotes();\n  const hasRemote = remotes.some((remote) => remote.name === options.remote);\n  let fetchFailed = false;\n  if (options.refresh && options.mode === \"managed\" && hasRemote) {\n    try {\n      await options.repository.fetch(options.remote);\n    } catch {\n      fetchFailed = true;\n      attention.add(\"fetch-failed\");\n    }\n  }\n  const branches = await options.repository.branches();\n  const localIdentity = branches.all.includes(options.identity.login);\n  const remoteIdentity = `remotes/${options.remote}/${options.identity.login}`;\n  const remotePrimary = `remotes/${options.remote}/${options.primaryBranch}`;\n  const hasRemoteIdentity = hasRemote && branches.all.includes(remoteIdentity);\n  const hasRemotePrimary = hasRemote && branches.all.includes(remotePrimary);\n  let updateCheck: RepositorySummary[\"updateCheck\"] =\n    options.mode === \"manual\" ? \"not-checked\" : \"unavailable\";\n\n  if (options.mode === \"managed\") {\n    if (fetchFailed) {\n      updateCheck = \"attention\";\n    } else if (!hasRemote) {\n      updateCheck = \"unavailable\";\n    } else if (!hasRemotePrimary || !localIdentity) {\n      updateCheck = \"attention\";\n      attention.add(\"missing-primary\");\n    } else {\n      try {\n        const primaryRelation = await refRelation(\n          options.repository,\n          options.identity.login,\n          remotePrimary,\n        );\n        updateCheck =\n          primaryRelation.behind > 0 ? \"updates-available\" : \"up-to-date\";\n        if (primaryRelation.behind > 0) {\n          addDiffChanges(\n            changes,\n            await diffPaths(\n              options.repository,\n              `${options.identity.login}..${remotePrimary}`,\n            ),\n            \"updates-available\",\n            prefix,\n            summaries,\n            options.identity,\n          );\n        }\n      } catch {\n        updateCheck = \"attention\";\n        attention.add(\"unknown\");\n      }\n    }\n\n    if (hasRemoteIdentity && localIdentity) {\n      try {\n        const identityRelation = await refRelation(\n          options.repository,\n          options.identity.login,\n          remoteIdentity,\n        );\n        if (identityRelation.ahead > 0) {\n          addDiffChanges(\n            changes,\n            await diffPaths(\n              options.repository,\n              `${remoteIdentity}..${options.identity.login}`,\n            ),\n            \"committed-unpushed\",\n            prefix,\n            summaries,\n            options.identity,\n          );\n        }\n      } catch {\n        attention.add(\"unknown\");\n      }\n    }\n  }\n\n  let readiness: RepositorySummary[\"readiness\"] = \"ready\";\n  if (detached || wrongBranch || unresolved) {\n    readiness = \"blocked\";\n  } else if (!status.clean) {\n    readiness = \"attention\";\n  }\n  return {\n    mode: options.mode,\n    readiness,\n    updateCheck,\n    changes: [...changes.values()].sort((left, right) =>\n      left.path < right.path ? -1 : left.path > right.path ? 1 : 0,\n    ),\n    attention: [...attention].sort(),\n    capabilities: getGitManagementCapabilities(options.mode),\n  };\n}\n"]}
+{"version":3,"file":"repository-summary.d.ts","sourceRoot":"","sources":["../../src/lifecycle/repository-summary.ts"],"names":[],"mappings":"AACA,OAAO,EAGL,KAAK,eAAe,EACpB,KAAK,OAAO,EAOZ,KAAK,0BAA0B,EAC/B,KAAK,iBAAiB,EACvB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AACpE,OAAO,EAAE,KAAK,aAAa,EAAsB,MAAM,sBAAsB,CAAC;AAG9E,MAAM,MAAM,wBAAwB,GAAG;IACrC,UAAU,EAAE,aAAa,CAAC;IAC1B,OAAO,EAAE,oBAAoB,CAAC;IAC9B,cAAc,EAAE,MAAM,CAAC;IACvB,aAAa,EAAE,MAAM,CAAC;IACtB,QAAQ,EAAE,eAAe,CAAC;IAC1B,IAAI,EAAE,OAAO,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,aAAa,EAAE,MAAM,CAAC;IACtB,8EAA8E;IAC9E,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,wEAAwE;IACxE,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,wEAAwE;IACxE,oBAAoB,CAAC,EAAE,0BAA0B,CAAC;IAClD,4DAA4D;IAC5D,kBAAkB,CAAC,EAAE,OAAO,CAAC;CAC9B,CAAC;AA+HF,wBAAsB,oBAAoB,CACxC,OAAO,EAAE,wBAAwB,GAChC,OAAO,CAAC,iBAAiB,CAAC,CAgJ5B","sourcesContent":["import { relative } from \"node:path\";\nimport {\n  getGitManagementCapabilities,\n  parseRepositoryRelativePath,\n  type BonfireIdentity,\n  type GitMode,\n  type PrototypeRef,\n  type PrototypeSummary,\n  type RepositoryAttentionCode,\n  type RepositoryChange,\n  type RepositoryChangeScope,\n  type RepositoryChangeStatus,\n  type BranchPreparationAttention,\n  type RepositorySummary,\n} from \"@ebay-dt/bonfire-core\";\nimport type { PrototypeCatalogLike } from \"../prototype-catalog.js\";\nimport { type GitRepository, type GitStatusFile } from \"../git-repository.js\";\nimport { hasUnresolvedRepositoryOperation } from \"./repository-synchronization.js\";\n\nexport type RepositorySummaryOptions = {\n  repository: GitRepository;\n  catalog: PrototypeCatalogLike;\n  repositoryRoot: string;\n  prototypeRoot: string;\n  identity: BonfireIdentity;\n  mode: GitMode;\n  remote: string;\n  primaryBranch: string;\n  /** True when the running server must restart to load updated dependencies. */\n  restartRequired?: boolean;\n  /** Fetch remote-tracking refs before comparing managed update state. */\n  refresh?: boolean;\n  /** Latest non-ready preparation attempt retained across clean reads. */\n  preparationAttention?: BranchPreparationAttention;\n  /** Protected dependency-installation marker, if present. */\n  preparationPending?: boolean;\n};\n\ntype SummaryPathContext = {\n  scope: RepositoryChangeScope;\n  prototype: PrototypeRef | undefined;\n};\n\nfunction normalizePath(value: string) {\n  return value.replaceAll(\"\\\\\", \"/\").replace(/^\\.\\//u, \"\");\n}\n\nfunction pathPrefix(repositoryRoot: string, prototypeRoot: string) {\n  const value = normalizePath(relative(repositoryRoot, prototypeRoot));\n  return value === \".\" ? \"\" : value.replace(/\\/+$/u, \"\");\n}\n\nfunction summaryKey(ref: PrototypeRef) {\n  return `${ref.login}/${ref.slug}`;\n}\n\nfunction contextForPath(\n  value: string,\n  prefix: string,\n  summaries: ReadonlyMap<string, PrototypeSummary>,\n  identity: BonfireIdentity,\n): SummaryPathContext {\n  const path = normalizePath(value);\n  const rest =\n    prefix === \"\"\n      ? path\n      : path.startsWith(`${prefix}/`)\n        ? path.slice(prefix.length + 1)\n        : null;\n  if (rest === null) return { scope: \"out-of-scope\", prototype: undefined };\n\n  const segments = rest.split(\"/\");\n  const login = segments[0];\n  const slug = segments[1];\n  if (login === undefined || slug === undefined) {\n    return { scope: \"unknown\", prototype: undefined };\n  }\n\n  const ref = { login, slug } satisfies PrototypeRef;\n  const summary = summaries.get(summaryKey(ref));\n  if (summary === undefined) return { scope: \"unknown\", prototype: undefined };\n\n  return {\n    scope: login === identity.login ? \"owned-prototype\" : \"other-prototype\",\n    prototype: ref,\n  };\n}\n\nfunction safePath(value: string) {\n  try {\n    return parseRepositoryRelativePath(normalizePath(value));\n  } catch {\n    return null;\n  }\n}\n\nfunction addChange(\n  changes: Map<string, RepositoryChange>,\n  path: string,\n  status: RepositoryChangeStatus,\n  context: SummaryPathContext,\n) {\n  const safe = safePath(path);\n  if (safe === null) return;\n  const key = `${status}:${safe}`;\n  changes.set(key, {\n    path: safe,\n    status,\n    scope: context.scope,\n    ...(context.prototype === undefined\n      ? {}\n      : { prototype: context.prototype }),\n  });\n}\n\nfunction statusPaths(file: GitStatusFile) {\n  return [file.path, ...(file.from === undefined ? [] : [file.from])];\n}\n\nasync function diffPaths(repository: GitRepository, range: string) {\n  const output = await repository.raw([\"diff\", \"--name-only\", \"-z\", range]);\n  return output.split(\"\\0\").filter((path) => path.length > 0);\n}\n\nasync function refRelation(\n  repository: GitRepository,\n  left: string,\n  right: string,\n) {\n  const output = await repository.raw([\n    \"rev-list\",\n    \"--left-right\",\n    \"--count\",\n    `${left}...${right}`,\n  ]);\n  const values = output.trim().split(/\\s+/u).map(Number);\n  if (\n    values.length !== 2 ||\n    values.some((value) => !Number.isSafeInteger(value) || value < 0)\n  ) {\n    throw new Error(\"Malformed Git ref relation\");\n  }\n  return { ahead: values[0]!, behind: values[1]! };\n}\n\nfunction addDiffChanges(\n  changes: Map<string, RepositoryChange>,\n  paths: readonly string[],\n  status: RepositoryChangeStatus,\n  prefix: string,\n  summaries: ReadonlyMap<string, PrototypeSummary>,\n  identity: BonfireIdentity,\n) {\n  for (const path of paths) {\n    addChange(\n      changes,\n      path,\n      status,\n      contextForPath(path, prefix, summaries, identity),\n    );\n  }\n}\n\nexport async function getRepositorySummary(\n  options: RepositorySummaryOptions,\n): Promise<RepositorySummary> {\n  const summaries = new Map(\n    (await options.catalog.scan()).map((summary) => [\n      summaryKey(summary.ref),\n      summary,\n    ]),\n  );\n  const prefix = pathPrefix(options.repositoryRoot, options.prototypeRoot);\n  const changes = new Map<string, RepositoryChange>();\n  const attention = new Set<RepositoryAttentionCode>();\n  const status = await options.repository.status();\n  const currentBranch = await options.repository.currentBranch();\n  const unresolved = await hasUnresolvedRepositoryOperation(options.repository);\n  const detached = currentBranch === \"HEAD\" || currentBranch.length === 0;\n  const wrongBranch = !detached && currentBranch !== options.identity.login;\n\n  for (const file of status.files) {\n    const fileStatus =\n      file.index.includes(\"U\") || file.workingDirectory.includes(\"U\")\n        ? \"unresolved\"\n        : \"uncommitted\";\n    for (const path of statusPaths(file)) {\n      addChange(\n        changes,\n        path,\n        fileStatus,\n        contextForPath(path, prefix, summaries, options.identity),\n      );\n    }\n  }\n\n  const dirtyWorktree = status.files.length > 0;\n  if (unresolved) attention.add(\"unresolved-operation\");\n  if (detached) attention.add(\"detached-head\");\n  if (wrongBranch) attention.add(\"wrong-branch\");\n\n  const remotes = await options.repository.remotes();\n  const hasRemote = remotes.some((remote) => remote.name === options.remote);\n  let fetchFailed = false;\n  if (options.refresh && options.mode === \"managed\" && hasRemote) {\n    try {\n      await options.repository.fetch(options.remote);\n    } catch {\n      fetchFailed = true;\n      attention.add(\"fetch-failed\");\n    }\n  }\n  const branches = await options.repository.branches();\n  const localIdentity = branches.all.includes(options.identity.login);\n  const remoteIdentity = `remotes/${options.remote}/${options.identity.login}`;\n  const remotePrimary = `remotes/${options.remote}/${options.primaryBranch}`;\n  const hasRemoteIdentity = hasRemote && branches.all.includes(remoteIdentity);\n  const hasRemotePrimary = hasRemote && branches.all.includes(remotePrimary);\n  let updateCheck: RepositorySummary[\"updateCheck\"] =\n    options.mode === \"manual\" ? \"not-checked\" : \"unavailable\";\n\n  if (options.mode === \"managed\") {\n    if (fetchFailed) {\n      updateCheck = \"attention\";\n    } else if (!hasRemote) {\n      updateCheck = \"unavailable\";\n    } else if (!hasRemotePrimary || !localIdentity) {\n      updateCheck = \"attention\";\n      attention.add(\"missing-primary\");\n    } else {\n      try {\n        const primaryRelation = await refRelation(\n          options.repository,\n          options.identity.login,\n          remotePrimary,\n        );\n        updateCheck =\n          primaryRelation.behind > 0 ? \"updates-available\" : \"up-to-date\";\n        if (primaryRelation.behind > 0) {\n          if (dirtyWorktree) attention.add(\"dirty-worktree\");\n          addDiffChanges(\n            changes,\n            await diffPaths(\n              options.repository,\n              `${options.identity.login}..${remotePrimary}`,\n            ),\n            \"updates-available\",\n            prefix,\n            summaries,\n            options.identity,\n          );\n        }\n      } catch {\n        updateCheck = \"attention\";\n        attention.add(\"unknown\");\n      }\n    }\n\n    if (hasRemoteIdentity && localIdentity) {\n      try {\n        const identityRelation = await refRelation(\n          options.repository,\n          options.identity.login,\n          remoteIdentity,\n        );\n        if (identityRelation.ahead > 0) {\n          addDiffChanges(\n            changes,\n            await diffPaths(\n              options.repository,\n              `${remoteIdentity}..${options.identity.login}`,\n            ),\n            \"committed-unpushed\",\n            prefix,\n            summaries,\n            options.identity,\n          );\n        }\n      } catch {\n        attention.add(\"unknown\");\n      }\n    }\n  }\n\n  let readiness: RepositorySummary[\"readiness\"] = \"ready\";\n  if (detached || wrongBranch || unresolved) {\n    readiness = \"blocked\";\n  } else if (!status.clean) {\n    readiness = \"attention\";\n  }\n  return {\n    mode: options.mode,\n    ...(options.preparationAttention === undefined\n      ? {}\n      : { preparationAttention: options.preparationAttention }),\n    ...(options.preparationPending === undefined\n      ? {}\n      : { preparationPending: options.preparationPending }),\n    ...(options.restartRequired === undefined\n      ? {}\n      : { restartRequired: options.restartRequired }),\n    readiness,\n    updateCheck,\n    changes: [...changes.values()].sort((left, right) =>\n      left.path < right.path ? -1 : left.path > right.path ? 1 : 0,\n    ),\n    attention: [...attention].sort(),\n    capabilities: getGitManagementCapabilities(options.mode),\n  };\n}\n"]}

package/dist/lifecycle/repository-summary.js

@@ -13,7 +13,11 @@ function summaryKey(ref) {
 }
 function contextForPath(value, prefix, summaries, identity) {
     const path = normalizePath(value);
-    const rest = prefix === "" ? path : path.startsWith(`${prefix}/`) ? path.slice(prefix.length + 1) : null;
+    const rest = prefix === ""
+        ? path
+        : path.startsWith(`${prefix}/`)
+            ? path.slice(prefix.length + 1)
+            : null;
     if (rest === null)
         return { scope: "out-of-scope", prototype: undefined };
     const segments = rest.split("/");
@@ -48,7 +52,9 @@ function addChange(changes, path, status, context) {
         path: safe,
         status,
         scope: context.scope,
-        ...(context.prototype === undefined ? {} : { prototype: context.prototype }),
+        ...(context.prototype === undefined
+            ? {}
+            : { prototype: context.prototype }),
     });
 }
 function statusPaths(file) {
@@ -98,8 +104,7 @@ export async function getRepositorySummary(options) {
             addChange(changes, path, fileStatus, contextForPath(path, prefix, summaries, options.identity));
         }
     }
-    if (status.files.length > 0)
-        attention.add("dirty-worktree");
+    const dirtyWorktree = status.files.length > 0;
     if (unresolved)
         attention.add("unresolved-operation");
     if (detached)
@@ -142,6 +147,8 @@ export async function getRepositorySummary(options) {
                 updateCheck =
                     primaryRelation.behind > 0 ? "updates-available" : "up-to-date";
                 if (primaryRelation.behind > 0) {
+                    if (dirtyWorktree)
+                        attention.add("dirty-worktree");
                     addDiffChanges(changes, await diffPaths(options.repository, `${options.identity.login}..${remotePrimary}`), "updates-available", prefix, summaries, options.identity);
                 }
             }
@@ -171,6 +178,15 @@ export async function getRepositorySummary(options) {
     }
     return {
         mode: options.mode,
+        ...(options.preparationAttention === undefined
+            ? {}
+            : { preparationAttention: options.preparationAttention }),
+        ...(options.preparationPending === undefined
+            ? {}
+            : { preparationPending: options.preparationPending }),
+        ...(options.restartRequired === undefined
+            ? {}
+            : { restartRequired: options.restartRequired }),
         readiness,
         updateCheck,
         changes: [...changes.values()].sort((left, right) => left.path < right.path ? -1 : left.path > right.path ? 1 : 0),