harnessbrew 0.4.0

package/dist/core/installations.js

@@ -0,0 +1,250 @@
+import { createHash } from "node:crypto";
+import { cp, lstat, mkdir, readFile, readdir, readlink, rename, rm, stat, writeFile } from "node:fs/promises";
+import path from "node:path";
+import { HarnessBrewError } from "./errors.js";
+import { getFormula, loadCatalog } from "./formulas.js";
+import { resolveCellarPath, resolveReceiptPath } from "./paths.js";
+async function walkFiles(root, current = root) {
+    const entries = await readdir(current, { withFileTypes: true });
+    const files = [];
+    for (const entry of entries.sort((left, right) => left.name.localeCompare(right.name))) {
+        const entryPath = path.join(current, entry.name);
+        if (entry.isDirectory())
+            files.push(...await walkFiles(root, entryPath));
+        else if (entry.isFile())
+            files.push(path.relative(root, entryPath));
+        else
+            throw new HarnessBrewError(`Unsupported file type in formula: ${entryPath}`);
+    }
+    return files;
+}
+async function digestFile(filePath) {
+    return createHash("sha256").update(await readFile(filePath)).digest("hex");
+}
+async function inventory(root) {
+    const files = await walkFiles(root);
+    return Promise.all(files.map(async (relativePath) => ({
+        path: relativePath,
+        sha256: await digestFile(path.join(root, relativePath))
+    })));
+}
+async function pathExists(filePath) {
+    try {
+        await stat(filePath);
+        return true;
+    }
+    catch (error) {
+        if (error.code === "ENOENT")
+            return false;
+        throw error;
+    }
+}
+export async function readReceipt(home, coordinate) {
+    const receiptPath = resolveReceiptPath(home, coordinate);
+    let content;
+    try {
+        content = await readFile(receiptPath, "utf8");
+    }
+    catch (error) {
+        if (error.code === "ENOENT")
+            return undefined;
+        throw error;
+    }
+    try {
+        const receipt = JSON.parse(content);
+        if (receipt.schemaVersion !== 1 || receipt.coordinate !== coordinate)
+            throw new Error("invalid receipt");
+        return receipt;
+    }
+    catch {
+        throw new HarnessBrewError(`Invalid install receipt: ${receiptPath}`);
+    }
+}
+export async function writeReceipt(home, receipt) {
+    const receiptPath = resolveReceiptPath(home, receipt.coordinate);
+    await mkdir(path.dirname(receiptPath), { recursive: true });
+    const temporaryPath = `${receiptPath}.${process.pid}.tmp`;
+    await writeFile(temporaryPath, `${JSON.stringify(receipt, null, 2)}\n`, "utf8");
+    await rename(temporaryPath, receiptPath);
+}
+export async function listInstalled(home) {
+    const receiptsRoot = path.join(home, "receipts");
+    if (!(await pathExists(receiptsRoot)))
+        return [];
+    const receiptPaths = (await walkFiles(receiptsRoot)).filter((file) => file.endsWith(".json"));
+    const receipts = [];
+    for (const relativePath of receiptPaths) {
+        const content = await readFile(path.join(receiptsRoot, relativePath), "utf8");
+        const receipt = JSON.parse(content);
+        if (receipt.schemaVersion !== 1 || typeof receipt.coordinate !== "string") {
+            throw new HarnessBrewError(`Invalid install receipt: ${path.join(receiptsRoot, relativePath)}`);
+        }
+        receipts.push(receipt);
+    }
+    return receipts.sort((left, right) => left.coordinate.localeCompare(right.coordinate));
+}
+export async function resolveDependencies(home, root) {
+    const catalog = await loadCatalog(home);
+    const formulas = new Map(catalog.map((formula) => [formula.coordinate, formula]));
+    const visiting = new Set();
+    const visited = new Set();
+    const ordered = [];
+    function visit(formula, trail) {
+        if (visiting.has(formula.coordinate)) {
+            throw new HarnessBrewError(`Dependency cycle detected: ${[...trail, formula.coordinate].join(" -> ")}`);
+        }
+        if (visited.has(formula.coordinate))
+            return;
+        visiting.add(formula.coordinate);
+        for (const dependencyCoordinate of formula.dependencies) {
+            const dependency = formulas.get(dependencyCoordinate);
+            if (dependency === undefined) {
+                throw new HarnessBrewError(`Dependency not found: ${formula.coordinate} -> ${dependencyCoordinate}`);
+            }
+            visit(dependency, [...trail, formula.coordinate]);
+        }
+        visiting.delete(formula.coordinate);
+        visited.add(formula.coordinate);
+        ordered.push(formula);
+    }
+    visit(root, []);
+    return ordered;
+}
+function assertNoConflicts(formulas, installed) {
+    const requested = new Set(formulas.map((formula) => formula.coordinate));
+    const installedCoordinates = new Set(installed.map((receipt) => receipt.coordinate));
+    for (const formula of formulas) {
+        for (const conflict of formula.conflicts) {
+            if (requested.has(conflict) || installedCoordinates.has(conflict)) {
+                throw new HarnessBrewError(`Formula conflict: ${formula.coordinate} conflicts with ${conflict}`);
+            }
+        }
+        const reciprocal = installed.find((receipt) => receipt.conflicts.includes(formula.coordinate));
+        if (reciprocal !== undefined) {
+            throw new HarnessBrewError(`Formula conflict: ${reciprocal.coordinate} conflicts with ${formula.coordinate}`);
+        }
+    }
+}
+export async function installCatalogFormula(home, formula, requested) {
+    const existing = await readReceipt(home, formula.coordinate);
+    if (existing !== undefined) {
+        if (requested && !existing.requested) {
+            existing.requested = true;
+            await writeReceipt(home, existing);
+        }
+        return existing;
+    }
+    const cellarPath = resolveCellarPath(home, formula.coordinate, formula.commit);
+    const temporaryPath = `${cellarPath}.${process.pid}.tmp`;
+    await mkdir(path.dirname(cellarPath), { recursive: true });
+    await rm(temporaryPath, { recursive: true, force: true });
+    try {
+        await cp(formula.directory, temporaryPath, { recursive: true, errorOnExist: true });
+        await rename(temporaryPath, cellarPath);
+        const receipt = {
+            schemaVersion: 1,
+            coordinate: formula.coordinate,
+            kind: formula.kind,
+            tap: formula.tap,
+            commit: formula.commit,
+            cellarPath,
+            entry: formula.entry,
+            dependencies: formula.dependencies,
+            conflicts: formula.conflicts,
+            requested,
+            files: await inventory(cellarPath),
+            supportedTargets: formula.targets,
+            targets: [],
+            links: [],
+            installedAt: new Date().toISOString()
+        };
+        await writeReceipt(home, receipt);
+        return receipt;
+    }
+    catch (error) {
+        await rm(temporaryPath, { recursive: true, force: true });
+        await rm(cellarPath, { recursive: true, force: true });
+        await rm(resolveReceiptPath(home, formula.coordinate), { force: true });
+        throw error;
+    }
+}
+export async function installFormula(home, nameOrCoordinate) {
+    const root = await getFormula(home, nameOrCoordinate);
+    if (root.deprecated !== undefined) {
+        throw new HarnessBrewError(`Formula is deprecated: ${root.coordinate}: ${root.deprecated}`);
+    }
+    const formulas = await resolveDependencies(home, root);
+    const installed = await listInstalled(home);
+    assertNoConflicts(formulas, installed);
+    const receipts = [];
+    const created = [];
+    try {
+        for (const formula of formulas) {
+            const existed = await readReceipt(home, formula.coordinate) !== undefined;
+            const receipt = await installCatalogFormula(home, formula, formula.coordinate === root.coordinate);
+            receipts.push(receipt);
+            if (!existed)
+                created.push(receipt);
+        }
+        return receipts;
+    }
+    catch (error) {
+        for (const receipt of created.reverse()) {
+            await rm(receipt.cellarPath, { recursive: true, force: true });
+            await rm(resolveReceiptPath(home, receipt.coordinate), { force: true });
+        }
+        throw error;
+    }
+}
+async function verifyReceiptFiles(receipt) {
+    for (const file of receipt.files) {
+        const filePath = path.join(receipt.cellarPath, file.path);
+        if (!(await pathExists(filePath)) || await digestFile(filePath) !== file.sha256) {
+            throw new HarnessBrewError(`Installed files were modified for ${receipt.coordinate}: ${file.path}`);
+        }
+    }
+}
+async function verifyReceiptLinks(receipt) {
+    for (const link of receipt.links) {
+        try {
+            const metadata = await lstat(link.path);
+            if (!metadata.isSymbolicLink() || path.resolve(path.dirname(link.path), await readlink(link.path)) !== link.source) {
+                throw new Error("link target changed");
+            }
+            if (await digestFile(link.source) !== link.sha256)
+                throw new Error("source changed");
+        }
+        catch {
+            throw new HarnessBrewError(`Installed target was modified for ${receipt.coordinate}: ${link.path}`);
+        }
+    }
+}
+export async function verifyReceiptIntegrity(receipt) {
+    await verifyReceiptFiles(receipt);
+    await verifyReceiptLinks(receipt);
+}
+export async function uninstallFormula(home, nameOrCoordinate, options = {}) {
+    const installed = await listInstalled(home);
+    const matches = nameOrCoordinate.split("/").length === 3
+        ? installed.filter((receipt) => receipt.coordinate === nameOrCoordinate)
+        : installed.filter((receipt) => receipt.coordinate.endsWith(`/${nameOrCoordinate}`));
+    if (matches.length === 0)
+        throw new HarnessBrewError(`Formula is not installed: ${nameOrCoordinate}`);
+    if (matches.length > 1)
+        throw new HarnessBrewError(`Installed formula name is ambiguous: ${nameOrCoordinate}`);
+    const receipt = matches[0];
+    const dependents = installed.filter((candidate) => candidate.dependencies.includes(receipt.coordinate));
+    if (dependents.length > 0 && options.force !== true) {
+        throw new HarnessBrewError(`Cannot uninstall ${receipt.coordinate}; required by ${dependents.map((item) => item.coordinate).join(", ")}`);
+    }
+    if (options.force !== true) {
+        await verifyReceiptIntegrity(receipt);
+    }
+    for (const link of receipt.links) {
+        await rm(link.path, { force: true });
+    }
+    await rm(receipt.cellarPath, { recursive: true, force: true });
+    await rm(resolveReceiptPath(home, receipt.coordinate), { force: true });
+    return receipt;
+}
+//# sourceMappingURL=installations.js.map

package/dist/core/installations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"installations.js","sourceRoot":"","sources":["../../src/core/installations.ts"],"names":[],"mappings":"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"}

package/dist/core/paths.d.ts

@@ -0,0 +1,8 @@
+export declare function resolveHarnessHome(override?: string): string;
+export declare function assertTapName(name: string): void;
+export declare function resolveTapPath(home: string, name: string): string;
+export declare function resolveStatePath(home: string): string;
+export declare function parseCoordinate(coordinate: string): [string, string, string];
+export declare function resolveCellarPath(home: string, coordinate: string, commit: string): string;
+export declare function resolveReceiptPath(home: string, coordinate: string): string;
+//# sourceMappingURL=paths.d.ts.map

package/dist/core/paths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../../src/core/paths.ts"],"names":[],"mappings":"AAMA,wBAAgB,kBAAkB,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAE5D;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAIhD;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAIjE;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAErD;AAED,wBAAgB,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAM5E;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAM1F;AAED,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAG3E"}

package/dist/core/paths.js

@@ -0,0 +1,39 @@
+import { homedir } from "node:os";
+import path from "node:path";
+import { HarnessBrewError } from "./errors.js";
+const tapNamePattern = /^[a-z0-9][a-z0-9-]*\/[a-z0-9][a-z0-9-]*$/;
+export function resolveHarnessHome(override) {
+    return path.resolve(override ?? process.env.HARNESSBREW_HOME ?? path.join(homedir(), ".harnessbrew"));
+}
+export function assertTapName(name) {
+    if (!tapNamePattern.test(name)) {
+        throw new HarnessBrewError(`Invalid tap name: ${name}. Expected <owner>/<name>.`);
+    }
+}
+export function resolveTapPath(home, name) {
+    assertTapName(name);
+    const [owner, tap] = name.split("/");
+    return path.join(home, "taps", owner, tap);
+}
+export function resolveStatePath(home) {
+    return path.join(home, "state.json");
+}
+export function parseCoordinate(coordinate) {
+    const parts = coordinate.split("/");
+    if (parts.length !== 3 || parts.some((part) => !/^[a-z0-9][a-z0-9-]*$/u.test(part))) {
+        throw new HarnessBrewError(`Invalid formula coordinate: ${coordinate}`);
+    }
+    return parts;
+}
+export function resolveCellarPath(home, coordinate, commit) {
+    const [owner, tap, formula] = parseCoordinate(coordinate);
+    if (!/^[0-9a-f]{40}$/u.test(commit)) {
+        throw new HarnessBrewError(`Invalid Git commit for ${coordinate}: ${commit}`);
+    }
+    return path.join(home, "cellar", owner, tap, formula, commit);
+}
+export function resolveReceiptPath(home, coordinate) {
+    const [owner, tap, formula] = parseCoordinate(coordinate);
+    return path.join(home, "receipts", owner, tap, `${formula}.json`);
+}
+//# sourceMappingURL=paths.js.map

package/dist/core/paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.js","sourceRoot":"","sources":["../../src/core/paths.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAE/C,MAAM,cAAc,GAAG,0CAA0C,CAAC;AAElE,MAAM,UAAU,kBAAkB,CAAC,QAAiB;IAClD,OAAO,IAAI,CAAC,OAAO,CAAC,QAAQ,IAAI,OAAO,CAAC,GAAG,CAAC,gBAAgB,IAAI,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,EAAE,cAAc,CAAC,CAAC,CAAC;AACxG,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,IAAY;IACxC,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QAC/B,MAAM,IAAI,gBAAgB,CAAC,qBAAqB,IAAI,4BAA4B,CAAC,CAAC;IACpF,CAAC;AACH,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,IAAY,EAAE,IAAY;IACvD,aAAa,CAAC,IAAI,CAAC,CAAC;IACpB,MAAM,CAAC,KAAK,EAAE,GAAG,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAqB,CAAC;IACzD,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,CAAC,CAAC;AAC7C,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,IAAY;IAC3C,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,YAAY,CAAC,CAAC;AACvC,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,UAAkB;IAChD,MAAM,KAAK,GAAG,UAAU,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACpC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,IAAI,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,uBAAuB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC;QACpF,MAAM,IAAI,gBAAgB,CAAC,+BAA+B,UAAU,EAAE,CAAC,CAAC;IAC1E,CAAC;IACD,OAAO,KAAiC,CAAC;AAC3C,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,IAAY,EAAE,UAAkB,EAAE,MAAc;IAChF,MAAM,CAAC,KAAK,EAAE,GAAG,EAAE,OAAO,CAAC,GAAG,eAAe,CAAC,UAAU,CAAC,CAAC;IAC1D,IAAI,CAAC,iBAAiB,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;QACpC,MAAM,IAAI,gBAAgB,CAAC,0BAA0B,UAAU,KAAK,MAAM,EAAE,CAAC,CAAC;IAChF,CAAC;IACD,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,GAAG,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;AAChE,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,IAAY,EAAE,UAAkB;IACjE,MAAM,CAAC,KAAK,EAAE,GAAG,EAAE,OAAO,CAAC,GAAG,eAAe,CAAC,UAAU,CAAC,CAAC;IAC1D,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,GAAG,EAAE,GAAG,OAAO,OAAO,CAAC,CAAC;AACpE,CAAC"}

package/dist/core/state.d.ts

@@ -0,0 +1,16 @@
+export interface TapRecord {
+    name: string;
+    url: string;
+    commit: string;
+    addedAt: string;
+    updatedAt: string;
+    ref?: string;
+}
+export interface HarnessState {
+    schemaVersion: 1;
+    taps: Record<string, TapRecord>;
+}
+export declare function emptyState(): HarnessState;
+export declare function readState(home: string): Promise<HarnessState>;
+export declare function writeState(home: string, state: HarnessState): Promise<void>;
+//# sourceMappingURL=state.d.ts.map

package/dist/core/state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"state.d.ts","sourceRoot":"","sources":["../../src/core/state.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,YAAY;IAC3B,aAAa,EAAE,CAAC,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;CACjC;AAED,wBAAgB,UAAU,IAAI,YAAY,CAEzC;AAED,wBAAsB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CA8BnE;AAED,wBAAsB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAMjF"}

package/dist/core/state.js

@@ -0,0 +1,43 @@
+import { mkdir, readFile, rename, writeFile } from "node:fs/promises";
+import path from "node:path";
+import { HarnessBrewError } from "./errors.js";
+import { resolveStatePath } from "./paths.js";
+export function emptyState() {
+    return { schemaVersion: 1, taps: {} };
+}
+export async function readState(home) {
+    const statePath = resolveStatePath(home);
+    let content;
+    try {
+        content = await readFile(statePath, "utf8");
+    }
+    catch (error) {
+        if (error.code === "ENOENT") {
+            return emptyState();
+        }
+        throw error;
+    }
+    let parsed;
+    try {
+        parsed = JSON.parse(content);
+    }
+    catch {
+        throw new HarnessBrewError(`Invalid HarnessBrew state file: ${statePath}`);
+    }
+    if (typeof parsed !== "object" ||
+        parsed === null ||
+        parsed.schemaVersion !== 1 ||
+        typeof parsed.taps !== "object" ||
+        parsed.taps === null) {
+        throw new HarnessBrewError(`Unsupported HarnessBrew state file: ${statePath}`);
+    }
+    return parsed;
+}
+export async function writeState(home, state) {
+    const statePath = resolveStatePath(home);
+    await mkdir(path.dirname(statePath), { recursive: true });
+    const temporaryPath = `${statePath}.${process.pid}.tmp`;
+    await writeFile(temporaryPath, `${JSON.stringify(state, null, 2)}\n`, "utf8");
+    await rename(temporaryPath, statePath);
+}
+//# sourceMappingURL=state.js.map

package/dist/core/state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"state.js","sourceRoot":"","sources":["../../src/core/state.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AACtE,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAgB9C,MAAM,UAAU,UAAU;IACxB,OAAO,EAAE,aAAa,EAAE,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC;AACxC,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,IAAY;IAC1C,MAAM,SAAS,GAAG,gBAAgB,CAAC,IAAI,CAAC,CAAC;IACzC,IAAI,OAAe,CAAC;IACpB,IAAI,CAAC;QACH,OAAO,GAAG,MAAM,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;IAC9C,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAK,KAA+B,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YACvD,OAAO,UAAU,EAAE,CAAC;QACtB,CAAC;QACD,MAAM,KAAK,CAAC;IACd,CAAC;IAED,IAAI,MAAe,CAAC;IACpB,IAAI,CAAC;QACH,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAC/B,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,gBAAgB,CAAC,mCAAmC,SAAS,EAAE,CAAC,CAAC;IAC7E,CAAC;IAED,IACE,OAAO,MAAM,KAAK,QAAQ;QAC1B,MAAM,KAAK,IAAI;QACd,MAAsC,CAAC,aAAa,KAAK,CAAC;QAC3D,OAAQ,MAA6B,CAAC,IAAI,KAAK,QAAQ;QACtD,MAA6B,CAAC,IAAI,KAAK,IAAI,EAC5C,CAAC;QACD,MAAM,IAAI,gBAAgB,CAAC,uCAAuC,SAAS,EAAE,CAAC,CAAC;IACjF,CAAC;IAED,OAAO,MAAsB,CAAC;AAChC,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,IAAY,EAAE,KAAmB;IAChE,MAAM,SAAS,GAAG,gBAAgB,CAAC,IAAI,CAAC,CAAC;IACzC,MAAM,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC1D,MAAM,aAAa,GAAG,GAAG,SAAS,IAAI,OAAO,CAAC,GAAG,MAAM,CAAC;IACxD,MAAM,SAAS,CAAC,aAAa,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IAC9E,MAAM,MAAM,CAAC,aAAa,EAAE,SAAS,CAAC,CAAC;AACzC,CAAC"}

package/dist/core/taps.d.ts

@@ -0,0 +1,16 @@
+import { type TapRecord } from "./state.js";
+export interface AddTapOptions {
+    ref?: string;
+}
+export interface TapUpdate {
+    name: string;
+    before: string;
+    after: string;
+    changed: boolean;
+}
+export declare function listTaps(home: string): Promise<TapRecord[]>;
+export declare function addTap(home: string, name: string, url: string, options?: AddTapOptions): Promise<TapRecord>;
+export declare function updateTaps(home: string, requestedName?: string): Promise<TapUpdate[]>;
+export declare function removeTap(home: string, name: string): Promise<TapRecord>;
+export declare function checkoutTap(home: string, name: string, commit: string): Promise<TapRecord>;
+//# sourceMappingURL=taps.d.ts.map

package/dist/core/taps.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"taps.d.ts","sourceRoot":"","sources":["../../src/core/taps.ts"],"names":[],"mappings":"AAMA,OAAO,EAAa,KAAK,SAAS,EAAc,MAAM,YAAY,CAAC;AAEnE,MAAM,WAAW,aAAa;IAC5B,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,wBAAsB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC,CAGjE;AAED,wBAAsB,MAAM,CAC1B,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,GAAG,EAAE,MAAM,EACX,OAAO,GAAE,aAAkB,GAC1B,OAAO,CAAC,SAAS,CAAC,CAmCpB;AAED,wBAAsB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,aAAa,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC,CA4B3F;AAED,wBAAsB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC,CAY9E;AAED,wBAAsB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC,CAehG"}

package/dist/core/taps.js

@@ -0,0 +1,102 @@
+import { mkdir, rm } from "node:fs/promises";
+import path from "node:path";
+import { HarnessBrewError } from "./errors.js";
+import { resolveGitCommit, runGit } from "./git.js";
+import { validateTapRepository } from "./formulas.js";
+import { assertTapName, resolveTapPath } from "./paths.js";
+import { readState, writeState } from "./state.js";
+export async function listTaps(home) {
+    const state = await readState(home);
+    return Object.values(state.taps).sort((left, right) => left.name.localeCompare(right.name));
+}
+export async function addTap(home, name, url, options = {}) {
+    assertTapName(name);
+    if (url.trim() === "") {
+        throw new HarnessBrewError("Tap Git URL must not be empty.");
+    }
+    const state = await readState(home);
+    if (state.taps[name] !== undefined) {
+        throw new HarnessBrewError(`Tap already exists: ${name}`);
+    }
+    const destination = resolveTapPath(home, name);
+    await mkdir(path.dirname(destination), { recursive: true });
+    try {
+        await runGit(["clone", "--quiet", "--", url, destination]);
+        const commit = await resolveGitCommit(destination, options.ref);
+        await runGit(["checkout", "--quiet", "--detach", commit], destination);
+        await validateTapRepository(destination);
+        const timestamp = new Date().toISOString();
+        const record = {
+            name,
+            url,
+            commit,
+            addedAt: timestamp,
+            updatedAt: timestamp,
+            ...(options.ref === undefined ? {} : { ref: options.ref })
+        };
+        state.taps[name] = record;
+        await writeState(home, state);
+        return record;
+    }
+    catch (error) {
+        await rm(destination, { recursive: true, force: true });
+        throw error;
+    }
+}
+export async function updateTaps(home, requestedName) {
+    if (requestedName !== undefined) {
+        assertTapName(requestedName);
+    }
+    const state = await readState(home);
+    const records = requestedName === undefined
+        ? Object.values(state.taps)
+        : [state.taps[requestedName]].filter((record) => record !== undefined);
+    if (requestedName !== undefined && records.length === 0) {
+        throw new HarnessBrewError(`Tap not found: ${requestedName}`);
+    }
+    const updates = [];
+    for (const record of records.sort((left, right) => left.name.localeCompare(right.name))) {
+        const repositoryPath = resolveTapPath(home, record.name);
+        await runGit(["fetch", "--quiet", "--prune", "--tags", "origin"], repositoryPath);
+        const commit = await resolveGitCommit(repositoryPath, record.ref);
+        await runGit(["checkout", "--quiet", "--detach", commit], repositoryPath);
+        await validateTapRepository(repositoryPath);
+        const before = record.commit;
+        record.commit = commit;
+        record.updatedAt = new Date().toISOString();
+        updates.push({ name: record.name, before, after: commit, changed: before !== commit });
+    }
+    await writeState(home, state);
+    return updates;
+}
+export async function removeTap(home, name) {
+    assertTapName(name);
+    const state = await readState(home);
+    const record = state.taps[name];
+    if (record === undefined) {
+        throw new HarnessBrewError(`Tap not found: ${name}`);
+    }
+    await rm(resolveTapPath(home, name), { recursive: true, force: true });
+    delete state.taps[name];
+    await writeState(home, state);
+    return record;
+}
+export async function checkoutTap(home, name, commit) {
+    assertTapName(name);
+    if (!/^[0-9a-f]{40}$/u.test(commit))
+        throw new HarnessBrewError(`Invalid Git commit: ${commit}`);
+    const state = await readState(home);
+    const record = state.taps[name];
+    if (record === undefined)
+        throw new HarnessBrewError(`Tap not found: ${name}`);
+    const repositoryPath = resolveTapPath(home, name);
+    await runGit(["fetch", "--quiet", "--prune", "--tags", "origin"], repositoryPath);
+    const resolved = await resolveGitCommit(repositoryPath, commit);
+    await runGit(["checkout", "--quiet", "--detach", resolved], repositoryPath);
+    await validateTapRepository(repositoryPath);
+    record.commit = resolved;
+    record.updatedAt = new Date().toISOString();
+    await writeState(home, state);
+    return record;
+}
+//# sourceMappingURL=taps.js.map

package/dist/core/taps.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"taps.js","sourceRoot":"","sources":["../../src/core/taps.ts"],"names":[],"mappings":"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"}

package/dist/core/targets.d.ts

@@ -0,0 +1,11 @@
+import { type InstallReceipt } from "./installations.js";
+export declare const builtinTargets: readonly ["openai-codex", "claude-code"];
+export type BuiltinTarget = (typeof builtinTargets)[number];
+export interface LinkOptions {
+    root?: string;
+}
+export declare function targetDestination(receipt: InstallReceipt, target: BuiltinTarget, root?: string): string;
+export declare function linkFormula(home: string, nameOrCoordinate: string, target: BuiltinTarget, options?: LinkOptions): Promise<InstallReceipt>;
+export declare function unlinkFormula(home: string, nameOrCoordinate: string, target: BuiltinTarget, force?: boolean): Promise<InstallReceipt>;
+export declare function installForTarget(home: string, nameOrCoordinate: string, target: BuiltinTarget, options?: LinkOptions): Promise<InstallReceipt[]>;
+//# sourceMappingURL=targets.d.ts.map

package/dist/core/targets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"targets.d.ts","sourceRoot":"","sources":["../../src/core/targets.ts"],"names":[],"mappings":"AAKA,OAAO,EAML,KAAK,cAAc,EAEpB,MAAM,oBAAoB,CAAC;AAG5B,eAAO,MAAM,cAAc,YAAI,cAAc,EAAE,aAAa,CAAU,CAAC;AACvE,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,cAAc,CAAC,CAAC,MAAM,CAAC,CAAC;AAE5D,MAAM,WAAW,WAAW;IAC1B,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAUD,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,cAAc,EAAE,MAAM,EAAE,aAAa,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAmBvG;AA+BD,wBAAsB,WAAW,CAC/B,IAAI,EAAE,MAAM,EACZ,gBAAgB,EAAE,MAAM,EACxB,MAAM,EAAE,aAAa,EACrB,OAAO,GAAE,WAAgB,GACxB,OAAO,CAAC,cAAc,CAAC,CAwCzB;AAED,wBAAsB,aAAa,CACjC,IAAI,EAAE,MAAM,EACZ,gBAAgB,EAAE,MAAM,EACxB,MAAM,EAAE,aAAa,EACrB,KAAK,UAAQ,GACZ,OAAO,CAAC,cAAc,CAAC,CAuBzB;AAED,wBAAsB,gBAAgB,CACpC,IAAI,EAAE,MAAM,EACZ,gBAAgB,EAAE,MAAM,EACxB,MAAM,EAAE,aAAa,EACrB,OAAO,GAAE,WAAgB,GACxB,OAAO,CAAC,cAAc,EAAE,CAAC,CAkB3B"}