agent-hitch 0.1.1 → 0.2.1

package/dist/src/feedback/service.js

@@ -0,0 +1,314 @@
+/**
+ * DSH-compatible message feedback sidecar (spec §6).
+ *
+ * One whole-session row bound to `{ sessionId, createdAt, cwd }`, stored as an
+ * atomic whole-row replacement. A lifecycle identity mismatch is treated as
+ * absence, preventing a reused session id from inheriting stale feedback.
+ * Forked sessions do not inherit feedback. Compare-and-set uses opaque opaque
+ * UUID versions; `ifVersion: null` requests creation only.
+ */
+import { randomUUID } from "node:crypto";
+import path from "node:path";
+import { atomicWriteJSON, ensureDir, readJSON } from "../foundation/index.js";
+import { validateMessageFeedbackRow } from "../domain/index.js";
+import { decodeSegment, encodeSegment, loadTrajectoryRef, readTrajectory, sessionDir } from "../trajectories/index.js";
+import { readFile, readdir } from "node:fs/promises";
+export class MessageFeedbackError extends Error {
+    code;
+    current;
+    maxBytes;
+    actualBytes;
+    constructor(code, message, extra = {}) {
+        super(message);
+        this.name = "MessageFeedbackError";
+        this.code = code;
+        if (extra.current !== undefined)
+            this.current = extra.current;
+        if (extra.maxBytes !== undefined)
+            this.maxBytes = extra.maxBytes;
+        if (extra.actualBytes !== undefined)
+            this.actualBytes = extra.actualBytes;
+    }
+}
+/**
+ * Infrastructure error for sidecar storage corruption or I/O failures. Unlike
+ * the business failure variants, this is not a `MessageFeedbackError` and must
+ * not be reported as one (spec §6.3).
+ */
+export class FeedbackStorageError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "FeedbackStorageError";
+    }
+}
+export const DEFAULT_MAX_NOTE_BYTES = 8192;
+/**
+ * The sidecar service. The session identity must be supplied by the caller
+ * (Hitch run records know `createdAt`/`cwd`); a row whose stored identity
+ * differs is treated as absent.
+ */
+export class MessageFeedbackService {
+    root;
+    maxNoteBytes;
+    validateTarget;
+    queues = new Map();
+    constructor({ root, maxNoteBytes = DEFAULT_MAX_NOTE_BYTES, validateTarget }) {
+        this.root = root;
+        this.maxNoteBytes = maxNoteBytes;
+        this.validateTarget = validateTarget;
+    }
+    rowPath(sessionId) {
+        return path.join(this.root, "feedback", "message-feedback.json");
+    }
+    serialize(sessionId, operation) {
+        const previous = this.queues.get(sessionId) || Promise.resolve();
+        const next = previous.then(operation, operation);
+        this.queues.set(sessionId, next.catch(() => { }));
+        return next;
+    }
+    async list(request, identity) {
+        return this.serialize(request.sessionId, async () => {
+            const row = await this.readRow(request.sessionId, identity);
+            return row ? [...row.items] : [];
+        });
+    }
+    async put(request, identity, target) {
+        validateNote(request.note, this.maxNoteBytes);
+        return this.serialize(request.sessionId, async () => {
+            if (this.validateTarget && !await this.validateTarget(request.sessionId, target.messageId)) {
+                throw new MessageFeedbackError("target-not-found", "no append-origin assistant message matches the requested messageId");
+            }
+            const row = await this.readRow(request.sessionId, identity);
+            const now = Date.now();
+            const existingIndex = row ? row.items.findIndex((item) => item.messageId === target.messageId) : -1;
+            const existing = existingIndex >= 0 && row ? row.items[existingIndex] : undefined;
+            if (request.ifVersion === null) {
+                if (existing)
+                    throw versionConflict(existing);
+                const created = {
+                    messageId: target.messageId,
+                    rating: request.rating,
+                    version: randomUUID(),
+                    createdAt: now,
+                    updatedAt: now,
+                };
+                if (request.note !== undefined)
+                    created.note = request.note;
+                const nextRow = row
+                    ? { ...row, items: [...row.items, created] }
+                    : { session: identitySession(identity), items: [created] };
+                await this.writeRow(request.sessionId, nextRow);
+                return created;
+            }
+            if (!existing)
+                throw versionConflict(null);
+            if (existing.version !== request.ifVersion)
+                throw versionConflict(existing);
+            const desiredNote = request.note;
+            const unchanged = existing.rating === request.rating
+                && existing.note === desiredNote
+                && existing.version === request.ifVersion;
+            if (unchanged)
+                return existing;
+            const updated = {
+                messageId: existing.messageId,
+                rating: request.rating,
+                version: randomUUID(),
+                createdAt: existing.createdAt,
+                updatedAt: Math.max(now, existing.updatedAt),
+            };
+            if (desiredNote !== undefined)
+                updated.note = desiredNote;
+            const items = [...(row?.items || [])];
+            items[existingIndex] = updated;
+            const nextRow = {
+                session: row?.session || identitySession(identity),
+                items,
+            };
+            await this.writeRow(request.sessionId, nextRow);
+            return updated;
+        });
+    }
+    async delete(request, identity) {
+        return this.serialize(request.sessionId, async () => {
+            const row = await this.readRow(request.sessionId, identity);
+            if (!row)
+                return { absent: true };
+            const existingIndex = row.items.findIndex((item) => item.messageId === request.messageId);
+            if (existingIndex < 0)
+                return { absent: true };
+            const existing = row.items[existingIndex];
+            // Delete ignores the supplied version only when the item is already
+            // absent; an existing item requires its exact current version even when
+            // `ifVersion` is null (spec §6.2). A null ifVersion therefore cannot
+            // delete an existing item.
+            if (existing && existing.version !== request.ifVersion) {
+                throw versionConflict(existing);
+            }
+            const items = row.items.filter((item) => item.messageId !== request.messageId);
+            await this.writeRow(request.sessionId, { ...row, items });
+            return { absent: true };
+        });
+    }
+    async readRow(sessionId, identity) {
+        const raw = await readJSON(this.rowPath(sessionId), null);
+        if (raw === null)
+            return null;
+        let row;
+        try {
+            row = validateMessageFeedbackRow(raw);
+        }
+        catch {
+            // Storage corruption and I/O failures are infrastructure errors, not
+            // business failure variants (spec §6.3): a corrupt row must never be
+            // misreported as session-not-found.
+            throw new FeedbackStorageError("message feedback sidecar is corrupt");
+        }
+        if (!sameIdentity(row.session, identity))
+            return null;
+        return row;
+    }
+    async writeRow(sessionId, row) {
+        const file = this.rowPath(sessionId);
+        await ensureDir(path.dirname(file));
+        await atomicWriteJSON(file, row);
+    }
+}
+function identitySession(identity) {
+    const session = {
+        sessionId: identity.sessionId,
+        createdAt: identity.createdAt,
+    };
+    if (identity.cwd !== undefined)
+        session.cwd = identity.cwd;
+    return session;
+}
+function sameIdentity(stored, expected) {
+    if (stored.sessionId !== undefined && stored.sessionId !== expected.sessionId)
+        return false;
+    if (stored.createdAt !== expected.createdAt)
+        return false;
+    if ((stored.cwd ?? undefined) !== (expected.cwd ?? undefined))
+        return false;
+    return true;
+}
+function validateNote(note, maxNoteBytes) {
+    if (note === undefined)
+        return;
+    if (!/\S/.test(note)) {
+        throw new MessageFeedbackError("note-blank", "note must contain a non-whitespace character");
+    }
+    const bytes = Buffer.byteLength(note, "utf8");
+    if (bytes > maxNoteBytes) {
+        throw new MessageFeedbackError("note-too-large", `note exceeds ${maxNoteBytes} UTF-8 bytes`, {
+            maxBytes: maxNoteBytes,
+            actualBytes: bytes,
+        });
+    }
+}
+function versionConflict(current) {
+    return new MessageFeedbackError("version-conflict", "message feedback version conflict", { current });
+}
+/**
+ * Resolve a run directory's canonical trajectory for feedback targeting.
+ * Returns `null` when the run has no trajectory ref (legacy event-log runs
+ * are not feedback targets).
+ */
+export async function resolveFeedbackSession(runDirectory) {
+    const ref = await loadTrajectoryRef(runDirectory);
+    if (!ref)
+        return null;
+    const header = await readTrajectoryHeader(ref.path);
+    if (!header)
+        return null;
+    return {
+        sessionId: ref.session_id,
+        createdAt: header.createdAt,
+        ...(header.cwd !== undefined ? { cwd: header.cwd } : {}),
+    };
+}
+async function readTrajectoryHeader(file) {
+    try {
+        const content = await readFile(file, "utf8");
+        const first = content.split(/\r?\n/).find((line) => line.length > 0);
+        if (!first)
+            return null;
+        const parsed = JSON.parse(first);
+        if (typeof parsed.createdAt !== "number")
+            return null;
+        const result = { createdAt: parsed.createdAt };
+        if (typeof parsed.cwd === "string")
+            result.cwd = parsed.cwd;
+        return result;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Validate that a messageId targets a non-empty, append-origin
+ * `assistant/message` in the run's canonical trajectory (spec §6.2).
+ */
+export async function trajectoryTargetValidator(runDirectory) {
+    return async (_sessionId, messageId) => {
+        const ref = await loadTrajectoryRef(runDirectory);
+        if (!ref)
+            return false;
+        try {
+            const { events } = await readTrajectory(ref.path);
+            return events.some((event) => {
+                if (event.type !== "assistant/message" || event.surfaceOp !== "append")
+                    return false;
+                const data = (event.data || {});
+                const message = (data.message || {});
+                if (message.id !== messageId)
+                    return false;
+                const content = Array.isArray(message.content) ? message.content : [];
+                const text = content.find((block) => block.type === "text")?.text;
+                return typeof text === "string" && text.length > 0;
+            });
+        }
+        catch {
+            return false;
+        }
+    };
+}
+/**
+ * Locate the canonical trajectory session.jsonl path for a session id under a
+ * run directory, scanning encoded session directories (used by the feedback
+ * CLI when only the session id is known).
+ */
+export async function findTrajectorySessionFile(runDirectory, sessionId) {
+    const ref = await loadTrajectoryRef(runDirectory);
+    if (ref)
+        return ref.path;
+    const root = path.join(runDirectory, "trajectory");
+    let projects;
+    try {
+        projects = await readdir(root, { withFileTypes: true });
+    }
+    catch {
+        return null;
+    }
+    const encoded = encodeSegment(sessionId);
+    for (const project of projects) {
+        if (!project.isDirectory())
+            continue;
+        const candidate = path.join(root, project.name, encoded, "session.jsonl");
+        try {
+            const content = await readFile(candidate, "utf8");
+            const first = content.split(/\r?\n/).find((line) => line.length > 0);
+            if (!first)
+                continue;
+            const parsed = JSON.parse(first);
+            if (parsed.id === sessionId || decodeSegment(encoded) === sessionId)
+                return candidate;
+        }
+        catch {
+            // Not this project.
+        }
+    }
+    return null;
+}
+export { sameIdentity, sessionDir };
+//# sourceMappingURL=service.js.map

package/dist/src/feedback/service.js.map

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

package/dist/src/foundation/config.js

@@ -0,0 +1,54 @@
+import { homedir } from "node:os";
+import path from "node:path";
+import { invalidInput } from "./errors.js";
+export const SCHEMA_VERSION = "1";
+export const DEFAULT_PORT = 7463;
+export const DEFAULT_MAX_CONCURRENT = 4;
+export function defaultRoot() {
+    return path.resolve(process.env.HITCH_ROOT || path.join(homedir(), ".hitch"));
+}
+export function parseDuration(value) {
+    if (value === undefined || value === null || value === "")
+        return 0;
+    if (typeof value === "number" && Number.isFinite(value))
+        return value;
+    const match = String(value).trim().match(/^(\d+(?:\.\d+)?)(ms|s|m|h)?$/);
+    if (!match)
+        throw invalidInput(`invalid duration: ${value}`);
+    const scale = { ms: 1, s: 1_000, m: 60_000, h: 3_600_000 };
+    const unit = match[2] || "ms";
+    return Math.round(Number(match[1]) * (scale[unit] ?? 1));
+}
+export function positiveInteger(value, name) {
+    const number = Number(value);
+    if (!Number.isInteger(number) || number <= 0) {
+        throw invalidInput(`${name} must be a positive integer`);
+    }
+    return number;
+}
+export function statePaths(root) {
+    return {
+        root,
+        daemon: path.join(root, "daemon.json"),
+        lock: path.join(root, "daemon.lock"),
+        token: path.join(root, "daemon.token"),
+        log: path.join(root, "daemon.log"),
+        errorLog: path.join(root, "daemon.err.log"),
+        runs: path.join(root, "runs"),
+        evals: path.join(root, "evals"),
+        tools: path.join(root, "tools"),
+        store: path.join(root, "store"),
+        artifacts: path.join(root, "store", "artifacts"),
+        artifactIndex: path.join(root, "store", "refs"),
+        sourceCache: path.join(root, "cache", "sources"),
+        artifactLocks: path.join(root, "locks", "artifacts"),
+        sourceLocks: path.join(root, "locks", "sources"),
+        workspaceLocks: path.join(root, "locks", "workspaces"),
+        controllerRuntimeLocks: path.join(root, "locks", "controller-runtimes"),
+        controllerRuntimes: path.join(root, "store", "controller-runtimes", "sha256"),
+        workspaces: path.join(root, "workspaces"),
+        temporary: path.join(root, "tmp"),
+        indexes: path.join(root, "indexes"),
+    };
+}
+//# sourceMappingURL=config.js.map

package/dist/src/foundation/config.js.map

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

package/dist/src/foundation/errors.js

@@ -0,0 +1,14 @@
+export class HitchError extends Error {
+    code;
+    exitCode;
+    constructor(message, { code = "internal_error", exitCode = 12, cause } = {}) {
+        super(message, cause === undefined ? undefined : { cause });
+        this.name = "HitchError";
+        this.code = code;
+        this.exitCode = exitCode;
+    }
+}
+export function invalidInput(message, { cause } = {}) {
+    return new HitchError(message, { code: "invalid_input", exitCode: 2, cause });
+}
+//# sourceMappingURL=errors.js.map

package/dist/src/foundation/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../../src/foundation/errors.ts"],"names":[],"mappings":"AAQA,MAAM,OAAO,UAAW,SAAQ,KAAK;IAC1B,IAAI,CAAS;IACb,QAAQ,CAAS;IAE1B,YAAY,OAAe,EAAE,EAAE,IAAI,GAAG,gBAAgB,EAAE,QAAQ,GAAG,EAAE,EAAE,KAAK,KAAwB,EAAE;QACpG,KAAK,CAAC,OAAO,EAAE,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;QAC5D,IAAI,CAAC,IAAI,GAAG,YAAY,CAAC;QACzB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC3B,CAAC;CACF;AAED,MAAM,UAAU,YAAY,CAAC,OAAe,EAAE,EAAE,KAAK,KAA0B,EAAE;IAC/E,OAAO,IAAI,UAAU,CAAC,OAAO,EAAE,EAAE,IAAI,EAAE,eAAe,EAAE,QAAQ,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;AAChF,CAAC"}

package/dist/src/foundation/executable.js

@@ -0,0 +1,135 @@
+import { spawn } from "node:child_process";
+import { createHash } from "node:crypto";
+import { constants, createReadStream } from "node:fs";
+import { access, lstat, realpath } from "node:fs/promises";
+import path, { delimiter, isAbsolute, join, resolve } from "node:path";
+import { HitchError } from "./errors.js";
+import { terminateProcess } from "./process.js";
+export function runCommand(executable, args, { cwd, env = process.env, failureCode = "internal_error", failureExitCode = 12, timeoutMs = 30 * 60 * 1_000, signal, } = {}) {
+    throwIfAborted(signal);
+    return new Promise((resolve, reject) => {
+        const child = spawn(executable, args, {
+            cwd,
+            env,
+            stdio: ["ignore", "pipe", "pipe"],
+            windowsHide: true,
+            detached: process.platform !== "win32",
+        });
+        let stdout = "";
+        let stderr = "";
+        let aborted = false;
+        let settled = false;
+        const append = (current, chunk) => `${current}${chunk}`.slice(-1_000_000);
+        child.stdout.on("data", (chunk) => { stdout = append(stdout, chunk); });
+        child.stderr.on("data", (chunk) => { stderr = append(stderr, chunk); });
+        const timer = setTimeout(() => terminateProcess(child).catch(() => { }), timeoutMs);
+        timer.unref?.();
+        const finish = (callback) => {
+            if (settled)
+                return;
+            settled = true;
+            clearTimeout(timer);
+            signal?.removeEventListener("abort", abortHandler);
+            callback();
+        };
+        const abortHandler = () => {
+            aborted = true;
+            terminateProcess(child).catch(() => { });
+        };
+        signal?.addEventListener("abort", abortHandler, { once: true });
+        child.once("error", (error) => {
+            finish(() => reject(new HitchError(`failed to start ${path.basename(executable)}: ${error.message}`, {
+                code: failureCode,
+                exitCode: failureExitCode,
+                cause: error,
+            })));
+        });
+        child.once("close", (code, processSignal) => {
+            if (aborted)
+                return finish(() => reject(cancelledError()));
+            if (code === 0)
+                return finish(() => resolve({ stdout, stderr }));
+            const detail = stderr.trim() || stdout.trim();
+            finish(() => reject(new HitchError(`${path.basename(executable)} exited with code ${code ?? "null"}${processSignal ? ` (${processSignal})` : ""}${detail ? `: ${detail}` : ""}`, { code: failureCode, exitCode: failureExitCode })));
+        });
+    });
+}
+export function commandExecutable(command, env) {
+    const override = {
+        npm: "HITCH_NPM_PATH",
+        git: "HITCH_GIT_PATH",
+        cargo: "HITCH_CARGO_PATH",
+        bun: "HITCH_BUN_PATH",
+        pnpm: "HITCH_PNPM_PATH",
+    }[command];
+    return override && env[override]?.trim() ? env[override].trim() : command;
+}
+export async function commandVersion(executable, env, signal) {
+    try {
+        return (await runCommand(executable, ["--version"], { env, signal, timeoutMs: 5_000 })).stdout.trim() || "unknown";
+    }
+    catch (error) {
+        if (error?.code === "cancelled")
+            throw error;
+        return "unknown";
+    }
+}
+function throwIfAborted(signal) {
+    if (signal?.aborted)
+        throw cancelledError();
+}
+function cancelledError() {
+    return new HitchError("harness preparation cancelled", { code: "cancelled", exitCode: 9 });
+}
+export async function resolveExecutable(command, searchPath) {
+    const candidates = isAbsolute(command) || command.includes("/") || command.includes("\\")
+        ? [resolve(command)]
+        : searchPath.split(delimiter).filter(Boolean).map((directory) => join(directory, command));
+    for (const candidate of candidates) {
+        try {
+            await access(candidate, constants.X_OK);
+            const info = await lstat(candidate);
+            if (info.isDirectory())
+                continue;
+            return await realpath(candidate);
+        }
+        catch {
+            // Keep probing PATH entries.
+        }
+    }
+    return null;
+}
+export async function detectVersion(executable, args, timeoutMs = 5_000) {
+    return new Promise((resolveVersion) => {
+        const child = spawn(executable, args, { stdio: ["ignore", "pipe", "pipe"], windowsHide: true });
+        let stdout = "";
+        let stderr = "";
+        const timer = setTimeout(() => child.kill("SIGKILL"), timeoutMs);
+        child.stdout.on("data", (chunk) => { stdout += chunk; });
+        child.stderr.on("data", (chunk) => { stderr += chunk; });
+        child.once("error", () => {
+            clearTimeout(timer);
+            resolveVersion("");
+        });
+        child.once("close", () => {
+            clearTimeout(timer);
+            resolveVersion(selectVersionLine(stdout, stderr));
+        });
+    });
+}
+export async function fingerprintExecutable(executable) {
+    const hash = createHash("sha256");
+    for await (const chunk of createReadStream(executable))
+        hash.update(chunk);
+    return `sha256:${hash.digest("hex")}`;
+}
+export function selectVersionLine(stdout, stderr) {
+    const versionPattern = /(?:^|\s)v?\d+\.\d+\.\d+(?:[-+][0-9A-Za-z.-]+)?(?:\s|$)/;
+    for (const stream of [stdout, stderr]) {
+        const match = String(stream || "").split(/\r?\n/).map((line) => line.trim()).find((line) => versionPattern.test(line));
+        if (match)
+            return match;
+    }
+    return "";
+}
+//# sourceMappingURL=executable.js.map

package/dist/src/foundation/executable.js.map

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

package/dist/src/foundation/fs.js

@@ -0,0 +1,45 @@
+import { mkdir, open, readFile, rename, rm, writeFile } from "node:fs/promises";
+import { randomBytes } from "node:crypto";
+import path from "node:path";
+export async function ensureDir(directory) {
+    await mkdir(directory, { recursive: true });
+    return directory;
+}
+/**
+ * Reads a JSON document. External JSON enters as `unknown`; callers narrow
+ * through runtime validators before use (spec §8.2).
+ */
+export async function readJSON(file, fallback) {
+    try {
+        return JSON.parse(await readFile(file, "utf8"));
+    }
+    catch (error) {
+        if (error?.code === "ENOENT" && fallback !== undefined)
+            return fallback;
+        throw error;
+    }
+}
+export async function atomicWriteJSON(file, value, mode = 0o600) {
+    await ensureDir(path.dirname(file));
+    const temporary = `${file}.${process.pid}.${Date.now()}.${randomBytes(6).toString("hex")}.tmp`;
+    await writeFile(temporary, `${JSON.stringify(value, null, 2)}\n`, { mode });
+    await rename(temporary, file);
+}
+export async function appendLine(file, value) {
+    await ensureDir(path.dirname(file));
+    const handle = await open(file, "a", 0o600);
+    try {
+        await handle.write(`${value}\n`);
+    }
+    finally {
+        await handle.close();
+    }
+}
+export async function removeIfExists(file) {
+    await rm(file, { force: true });
+}
+export async function writePrivateFile(file, value) {
+    await ensureDir(path.dirname(file));
+    await writeFile(file, value, { mode: 0o600 });
+}
+//# sourceMappingURL=fs.js.map

package/dist/src/foundation/fs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fs.js","sourceRoot":"","sources":["../../../src/foundation/fs.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAChF,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,SAAiB;IAC/C,MAAM,KAAK,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC5C,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAc,IAAY,EAAE,QAAY;IACpE,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,CAAM,CAAC;IACvD,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAK,KAA+B,EAAE,IAAI,KAAK,QAAQ,IAAI,QAAQ,KAAK,SAAS;YAAE,OAAO,QAAQ,CAAC;QACnG,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,IAAY,EAAE,KAAc,EAAE,IAAI,GAAG,KAAK;IAC9E,MAAM,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;IACpC,MAAM,SAAS,GAAG,GAAG,IAAI,IAAI,OAAO,CAAC,GAAG,IAAI,IAAI,CAAC,GAAG,EAAE,IAAI,WAAW,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAC;IAC/F,MAAM,SAAS,CAAC,SAAS,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;IAC5E,MAAM,MAAM,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;AAChC,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,IAAY,EAAE,KAAa;IAC1D,MAAM,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;IACpC,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,IAAI,EAAE,GAAG,EAAE,KAAK,CAAC,CAAC;IAC5C,IAAI,CAAC;QACH,MAAM,MAAM,CAAC,KAAK,CAAC,GAAG,KAAK,IAAI,CAAC,CAAC;IACnC,CAAC;YAAS,CAAC;QACT,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC;IACvB,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,IAAY;IAC/C,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;AAClC,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,IAAY,EAAE,KAAa;IAChE,MAAM,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;IACpC,MAAM,SAAS,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;AAChD,CAAC"}

package/dist/src/foundation/hash.js

@@ -0,0 +1,24 @@
+import { createHash } from "node:crypto";
+export function canonicalJSON(value) {
+    if (Array.isArray(value))
+        return `[${value.map(canonicalJSON).join(",")}]`;
+    if (value && typeof value === "object") {
+        const record = value;
+        return `{${Object.keys(record)
+            .filter((key) => record[key] !== undefined)
+            .sort()
+            .map((key) => `${JSON.stringify(key)}:${canonicalJSON(record[key])}`)
+            .join(",")}}`;
+    }
+    return JSON.stringify(value);
+}
+export function sha256JSON(value) {
+    return `sha256:${createHash("sha256").update(canonicalJSON(value)).digest("hex")}`;
+}
+export function sha256Bytes(value) {
+    return `sha256:${createHash("sha256").update(value).digest("hex")}`;
+}
+export function digest(value) {
+    return sha256JSON(value);
+}
+//# sourceMappingURL=hash.js.map

package/dist/src/foundation/hash.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hash.js","sourceRoot":"","sources":["../../../src/foundation/hash.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAGzC,MAAM,UAAU,aAAa,CAAC,KAAc;IAC1C,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,IAAI,KAAK,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC;IAC3E,IAAI,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QACvC,MAAM,MAAM,GAAG,KAAgC,CAAC;QAChD,OAAO,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC;aAC3B,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,SAAS,CAAC;aAC1C,IAAI,EAAE;aACN,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,aAAa,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC;aACpE,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC;IAClB,CAAC;IACD,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;AAC/B,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,KAAc;IACvC,OAAO,UAAU,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;AACrF,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,KAAsB;IAChD,OAAO,UAAU,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;AACtE,CAAC;AAED,MAAM,UAAU,MAAM,CAAC,KAAc;IACnC,OAAO,UAAU,CAAC,KAAK,CAAC,CAAC;AAC3B,CAAC"}

package/dist/src/foundation/index.js

@@ -0,0 +1,11 @@
+export { DEFAULT_MAX_CONCURRENT, DEFAULT_PORT, SCHEMA_VERSION, defaultRoot, parseDuration, positiveInteger, statePaths } from "./config.js";
+export { HitchError, invalidInput } from "./errors.js";
+export { appendLine, atomicWriteJSON, ensureDir, readJSON, removeIfExists, writePrivateFile } from "./fs.js";
+export { reclaimStaleLock } from "./locks.js";
+export { withFileLock } from "./locks.js";
+export { consumeLines } from "./line-stream.js";
+export { packageRoot, packageVersion } from "./package-root.js";
+export { delay, terminateProcess } from "./process.js";
+export { commandExecutable, commandVersion, detectVersion, fingerprintExecutable, resolveExecutable, runCommand, selectVersionLine } from "./executable.js";
+export { canonicalJSON, digest, sha256Bytes, sha256JSON } from "./hash.js";
+//# sourceMappingURL=index.js.map