humanish 0.15.0 → 0.15.2

package/dist/run-paths.d.ts

@@ -0,0 +1,56 @@
+export declare const RUNS_RELATIVE_ROOT: string;
+export declare const LATEST_RUN_RELATIVE_PATH: string;
+export interface RunArtifactPaths {
+    absoluteRunRoot: string;
+    relativeRunRoot: string;
+    absoluteLatestPointer: string;
+    relativeLatestPointer: string;
+}
+export interface PreparedRunArtifactPaths extends RunArtifactPaths {
+    readonly physicalLatestPointer: string;
+    readonly physicalRunRoot: string;
+    readonly physicalRunsRoot: string;
+    readonly runRootIdentity: FileIdentity;
+    readonly runsRootIdentity: FileIdentity;
+}
+interface FileIdentity {
+    readonly birthtimeNs: bigint;
+    readonly dev: bigint;
+    readonly ino: bigint;
+}
+export interface LatestRunPathPointer {
+    runId: string;
+    path: string;
+}
+/**
+ * Run ids are directory names, not paths. Keep the accepted grammar broad so
+ * existing runs remain readable while rejecting every path-shaped input.
+ */
+export declare function isSafeRunIdSegment(runId: string): boolean;
+export declare function resolveRunsRoot(cwdInput: string): string;
+export declare function resolveRunDirectory(cwdInput: string, runId: string): string;
+export declare function tryResolveRunDirectory(cwdInput: string, runId: string): string | null;
+export declare function resolveRunArtifactPaths(cwdInput: string, runId: string): RunArtifactPaths;
+export declare function prepareRunArtifactPaths(cwdInput: string, runId: string): Promise<PreparedRunArtifactPaths>;
+export declare function validatePreparedRunArtifactPaths(prepared: PreparedRunArtifactPaths): Promise<PreparedRunArtifactPaths>;
+/** Cheap revalidation for repeated contained reads/writes within one prepared run. */
+export declare function validatePreparedRunRootIdentity(prepared: PreparedRunArtifactPaths): Promise<PreparedRunArtifactPaths>;
+/** Bind an already-existing safe run as a new identity; this is not prior-preparation proof. */
+export declare function bindExistingRunArtifactPaths(cwdInput: string, runId: string): Promise<PreparedRunArtifactPaths>;
+export declare function resolveExistingRunDirectory(cwdInput: string, runId: string): Promise<string | null>;
+/**
+ * A latest pointer is valid only when both fields identify the same direct
+ * child of .humanish/runs. Callers must never use pointer.path directly.
+ */
+export declare function resolveLatestRunDirectory(cwdInput: string, pointer: LatestRunPathPointer): string | null;
+export declare function resolveExistingLatestRunDirectory(cwdInput: string, pointer: LatestRunPathPointer): Promise<string | null>;
+export declare function isRegularHumanishStorageFile(cwdInput: string, ...segments: string[]): Promise<boolean>;
+export declare function prepareHumanishStorageDirectory(cwdInput: string, ...segments: string[]): Promise<string>;
+export declare function prepareReusableHumanishStorageDirectory(cwdInput: string, ...segments: string[]): Promise<string>;
+export declare function prepareExclusiveHumanishStorageDirectories(cwdInput: string, segmentSets: string[][]): Promise<string[]>;
+export declare function prepareExclusiveHumanishStorageDirectory(cwdInput: string, ...segments: string[]): Promise<string>;
+export declare function prepareHumanishStorageFile(cwdInput: string, ...segments: string[]): Promise<string>;
+export declare function resolveHumanishStorageDirectory(cwdInput: string, ...segments: string[]): string;
+export declare function resolveExistingHumanishStorageDirectory(cwdInput: string, ...segments: string[]): Promise<string | null>;
+export declare function isPathInside(rootInput: string, candidateInput: string): boolean;
+export {};

package/dist/run-paths.js

@@ -0,0 +1,340 @@
+import { lstat, mkdir, readdir, realpath } from "node:fs/promises";
+import path from "node:path";
+export const RUNS_RELATIVE_ROOT = path.join(".humanish", "runs");
+export const LATEST_RUN_RELATIVE_PATH = path.join(RUNS_RELATIVE_ROOT, "latest.json");
+/**
+ * Run ids are directory names, not paths. Keep the accepted grammar broad so
+ * existing runs remain readable while rejecting every path-shaped input.
+ */
+export function isSafeRunIdSegment(runId) {
+    return runId.length > 0
+        && runId !== "."
+        && runId !== ".."
+        && !runId.includes("/")
+        && !runId.includes("\\")
+        && !runId.includes("\0");
+}
+export function resolveRunsRoot(cwdInput) {
+    return path.resolve(cwdInput, RUNS_RELATIVE_ROOT);
+}
+export function resolveRunDirectory(cwdInput, runId) {
+    if (!isSafeRunIdSegment(runId)) {
+        throw new Error("Run id must be one non-empty path segment.");
+    }
+    const runsRoot = resolveRunsRoot(cwdInput);
+    const runRoot = path.resolve(runsRoot, runId);
+    if (!isPathInside(runsRoot, runRoot) || path.dirname(runRoot) !== runsRoot) {
+        throw new Error("Run directory must stay inside the Humanish runs root.");
+    }
+    return runRoot;
+}
+export function tryResolveRunDirectory(cwdInput, runId) {
+    try {
+        return resolveRunDirectory(cwdInput, runId);
+    }
+    catch {
+        return null;
+    }
+}
+export function resolveRunArtifactPaths(cwdInput, runId) {
+    if (runId === "latest.json") {
+        throw new Error("Run id is reserved; choose a different run id.");
+    }
+    const absoluteRunRoot = resolveRunDirectory(cwdInput, runId);
+    return {
+        absoluteRunRoot,
+        relativeRunRoot: path.join(RUNS_RELATIVE_ROOT, runId),
+        absoluteLatestPointer: path.resolve(cwdInput, LATEST_RUN_RELATIVE_PATH),
+        relativeLatestPointer: LATEST_RUN_RELATIVE_PATH
+    };
+}
+export async function prepareRunArtifactPaths(cwdInput, runId) {
+    const paths = resolveRunArtifactPaths(cwdInput, runId);
+    const prepared = await prepareHumanishStorageDirectory(cwdInput, "runs", runId);
+    if (prepared !== paths.absoluteRunRoot) {
+        throw new Error("Run directory resolved outside the expected storage root.");
+    }
+    await assertNoSymlinkDescendants(prepared);
+    await assertRegularFileOrMissing(paths.absoluteLatestPointer);
+    return validatePreparedRunArtifactPaths(await capturePreparedRunArtifactPaths(paths, prepared));
+}
+export async function validatePreparedRunArtifactPaths(prepared) {
+    await validatePreparedRunRootIdentity(prepared);
+    await assertNoSymlinkDescendants(prepared.physicalRunRoot);
+    await assertRegularFileOrMissing(prepared.physicalLatestPointer);
+    return prepared;
+}
+/** Cheap revalidation for repeated contained reads/writes within one prepared run. */
+export async function validatePreparedRunRootIdentity(prepared) {
+    const [lexicalRunsRoot, lexicalRunRoot] = await Promise.all([
+        realpath(path.dirname(prepared.absoluteRunRoot)),
+        realpath(prepared.absoluteRunRoot)
+    ]);
+    if (lexicalRunsRoot !== prepared.physicalRunsRoot || lexicalRunRoot !== prepared.physicalRunRoot) {
+        throw new Error("Prepared Humanish run storage changed physical destination.");
+    }
+    await Promise.all([
+        assertDirectoryIdentity(prepared.physicalRunsRoot, prepared.runsRootIdentity),
+        assertDirectoryIdentity(prepared.physicalRunRoot, prepared.runRootIdentity)
+    ]);
+    return prepared;
+}
+/** Bind an already-existing safe run as a new identity; this is not prior-preparation proof. */
+export async function bindExistingRunArtifactPaths(cwdInput, runId) {
+    const paths = resolveRunArtifactPaths(cwdInput, runId);
+    const existing = await resolveExistingRunDirectory(cwdInput, runId);
+    if (!existing || existing !== paths.absoluteRunRoot) {
+        throw new Error("Run directory is not an existing Humanish run directory.");
+    }
+    await assertNoSymlinkDescendants(existing);
+    await assertRegularFileOrMissing(paths.absoluteLatestPointer);
+    return validatePreparedRunArtifactPaths(await capturePreparedRunArtifactPaths(paths, existing));
+}
+export async function resolveExistingRunDirectory(cwdInput, runId) {
+    const expected = tryResolveRunDirectory(cwdInput, runId);
+    if (!expected) {
+        return null;
+    }
+    const existing = await resolveExistingHumanishStorageDirectory(cwdInput, "runs", runId);
+    return existing === expected ? existing : null;
+}
+/**
+ * A latest pointer is valid only when both fields identify the same direct
+ * child of .humanish/runs. Callers must never use pointer.path directly.
+ */
+export function resolveLatestRunDirectory(cwdInput, pointer) {
+    const expected = tryResolveRunDirectory(cwdInput, pointer.runId);
+    if (!expected || !isProjectRelativePath(pointer.path)) {
+        return null;
+    }
+    const declared = path.resolve(cwdInput, pointer.path);
+    return declared === expected ? expected : null;
+}
+export async function resolveExistingLatestRunDirectory(cwdInput, pointer) {
+    const expected = resolveLatestRunDirectory(cwdInput, pointer);
+    if (!expected) {
+        return null;
+    }
+    const existing = await resolveExistingRunDirectory(cwdInput, pointer.runId);
+    return existing === expected ? existing : null;
+}
+export async function isRegularHumanishStorageFile(cwdInput, ...segments) {
+    const parent = await resolveExistingHumanishStorageDirectory(cwdInput, ...segments.slice(0, -1));
+    const fileName = segments.at(-1);
+    if (!parent || !fileName || !isSafeStorageSegment(fileName)) {
+        return false;
+    }
+    try {
+        const stats = await lstat(path.join(parent, fileName));
+        return stats.isFile() && !stats.isSymbolicLink() && stats.nlink === 1;
+    }
+    catch (error) {
+        if (isNodeError(error) && error.code === "ENOENT") {
+            return false;
+        }
+        throw error;
+    }
+}
+export async function prepareHumanishStorageDirectory(cwdInput, ...segments) {
+    const prepared = await walkHumanishStorage(cwdInput, segments, true);
+    if (!prepared) {
+        throw new Error("Humanish storage directory could not be created.");
+    }
+    return prepared;
+}
+export async function prepareReusableHumanishStorageDirectory(cwdInput, ...segments) {
+    const prepared = await prepareHumanishStorageDirectory(cwdInput, ...segments);
+    await assertNoSymlinkDescendants(prepared);
+    return prepared;
+}
+export async function prepareExclusiveHumanishStorageDirectories(cwdInput, segmentSets) {
+    const targets = [];
+    for (const segments of segmentSets) {
+        assertSafeStorageSegments(segments);
+        const name = segments.at(-1);
+        if (!name) {
+            throw new Error("Exclusive Humanish storage directory needs a leaf segment.");
+        }
+        const parent = await prepareHumanishStorageDirectory(cwdInput, ...segments.slice(0, -1));
+        const target = path.join(parent, name);
+        try {
+            await lstat(target);
+            throw new Error("Humanish storage id already exists; choose a new id.");
+        }
+        catch (error) {
+            if (!isNodeError(error) || error.code !== "ENOENT") {
+                throw error;
+            }
+        }
+        targets.push(target);
+    }
+    for (const target of targets) {
+        try {
+            await mkdir(target);
+        }
+        catch (error) {
+            if (isNodeError(error) && error.code === "EEXIST") {
+                throw new Error("Humanish storage id already exists; choose a new id.");
+            }
+            throw error;
+        }
+    }
+    return targets;
+}
+export async function prepareExclusiveHumanishStorageDirectory(cwdInput, ...segments) {
+    const [target] = await prepareExclusiveHumanishStorageDirectories(cwdInput, [segments]);
+    if (!target) {
+        throw new Error("Exclusive Humanish storage directory was not created.");
+    }
+    return target;
+}
+export async function prepareHumanishStorageFile(cwdInput, ...segments) {
+    const fileName = segments.at(-1);
+    if (!fileName || !isSafeStorageSegment(fileName)) {
+        throw new Error("Humanish storage file must use a non-empty path segment.");
+    }
+    const parent = await prepareHumanishStorageDirectory(cwdInput, ...segments.slice(0, -1));
+    const filePath = path.join(parent, fileName);
+    await assertRegularFileOrMissing(filePath);
+    return filePath;
+}
+export function resolveHumanishStorageDirectory(cwdInput, ...segments) {
+    assertSafeStorageSegments(segments);
+    const humanishRoot = path.resolve(cwdInput, ".humanish");
+    const resolved = path.resolve(humanishRoot, ...segments);
+    if (!isPathInside(humanishRoot, resolved)) {
+        throw new Error("Humanish storage directory must stay inside .humanish.");
+    }
+    return resolved;
+}
+export async function resolveExistingHumanishStorageDirectory(cwdInput, ...segments) {
+    return walkHumanishStorage(cwdInput, segments, false);
+}
+export function isPathInside(rootInput, candidateInput) {
+    const root = path.resolve(rootInput);
+    const candidate = path.resolve(candidateInput);
+    const relative = path.relative(root, candidate);
+    return relative === ""
+        || (relative !== ".." && !relative.startsWith(`..${path.sep}`) && !path.isAbsolute(relative));
+}
+function isProjectRelativePath(value) {
+    const parts = value.replace(/\\/g, "/").split("/");
+    return value.length > 0
+        && !path.isAbsolute(value)
+        && !path.posix.isAbsolute(value)
+        && !path.win32.isAbsolute(value)
+        && !value.includes("\0")
+        && !parts.some((part) => part === "." || part === "..");
+}
+async function walkHumanishStorage(cwdInput, segments, create) {
+    assertSafeStorageSegments(segments);
+    let current = path.resolve(cwdInput);
+    for (const segment of [".humanish", ...segments]) {
+        current = path.join(current, segment);
+        let stats;
+        try {
+            stats = await lstat(current);
+        }
+        catch (error) {
+            if (!isNodeError(error) || error.code !== "ENOENT") {
+                throw error;
+            }
+            if (!create) {
+                return null;
+            }
+            try {
+                await mkdir(current);
+            }
+            catch (mkdirError) {
+                if (!isNodeError(mkdirError) || mkdirError.code !== "EEXIST") {
+                    throw mkdirError;
+                }
+            }
+            stats = await lstat(current);
+        }
+        if (stats.isSymbolicLink()) {
+            throw new Error("Humanish storage directories must not be symbolic links.");
+        }
+        if (!stats.isDirectory()) {
+            throw new Error("ENOTDIR: Humanish storage path must be a directory.");
+        }
+    }
+    return current;
+}
+function assertSafeStorageSegments(segments) {
+    if (!segments.every(isSafeStorageSegment)) {
+        throw new Error("Humanish storage paths must use non-empty path segments.");
+    }
+}
+function isSafeStorageSegment(segment) {
+    return segment.length > 0
+        && segment !== "."
+        && segment !== ".."
+        && !segment.includes("/")
+        && !segment.includes("\\")
+        && !segment.includes("\0");
+}
+function isNodeError(error) {
+    return error instanceof Error && "code" in error;
+}
+async function assertRegularFileOrMissing(filePath) {
+    try {
+        const stats = await lstat(filePath);
+        if (stats.isSymbolicLink() || !stats.isFile() || stats.nlink > 1) {
+            throw new Error("Humanish storage files must be single-link regular files, not symbolic links or hardlinks.");
+        }
+    }
+    catch (error) {
+        if (isNodeError(error) && error.code === "ENOENT") {
+            return;
+        }
+        throw error;
+    }
+}
+async function assertNoSymlinkDescendants(directory) {
+    const entries = await readdir(directory, { withFileTypes: true });
+    for (const entry of entries) {
+        const child = path.join(directory, entry.name);
+        const stats = await lstat(child);
+        if (stats.isSymbolicLink()) {
+            throw new Error("Humanish run directories must not contain symbolic links.");
+        }
+        if (stats.isDirectory()) {
+            await assertNoSymlinkDescendants(child);
+        }
+        else if (!stats.isFile() || stats.nlink > 1) {
+            throw new Error("Humanish run leaves must be single-link regular files, not hardlinks or special files.");
+        }
+    }
+}
+async function capturePreparedRunArtifactPaths(paths, runRoot) {
+    const physicalRunRoot = await realpath(runRoot);
+    const physicalRunsRoot = await realpath(path.dirname(runRoot));
+    const [runStats, runsStats] = await Promise.all([
+        lstat(physicalRunRoot, { bigint: true }),
+        lstat(physicalRunsRoot, { bigint: true })
+    ]);
+    if (!runStats.isDirectory() || runStats.isSymbolicLink() || !runsStats.isDirectory() || runsStats.isSymbolicLink()) {
+        throw new Error("Prepared Humanish run storage must use physical directories.");
+    }
+    return Object.freeze({
+        ...paths,
+        physicalLatestPointer: path.join(physicalRunsRoot, "latest.json"),
+        physicalRunRoot,
+        physicalRunsRoot,
+        runRootIdentity: Object.freeze({ birthtimeNs: runStats.birthtimeNs, dev: runStats.dev, ino: runStats.ino }),
+        runsRootIdentity: Object.freeze({ birthtimeNs: runsStats.birthtimeNs, dev: runsStats.dev, ino: runsStats.ino })
+    });
+}
+async function assertDirectoryIdentity(directory, identity) {
+    const stats = await lstat(directory, { bigint: true });
+    if (stats.isSymbolicLink()
+        || !stats.isDirectory()
+        || stats.birthtimeNs !== identity.birthtimeNs
+        || stats.dev !== identity.dev
+        || stats.ino !== identity.ino
+        || await realpath(directory) !== directory) {
+        throw new Error("Prepared Humanish run storage identity changed.");
+    }
+}
+//# sourceMappingURL=run-paths.js.map

package/dist/run-paths.js.map

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

package/dist/run.d.ts

@@ -1,7 +1,8 @@
 import { type CodexAppServerTrace } from "./codex-app-server.js";
 import { type ActorTrace } from "./actor-contract.js";
 import { type CapturedGitState } from "./core/git-state.js";
-import { type E2BDesktopModule } from "./e2b-desktop-launch.js";
+import type { E2BDesktopModule } from "./e2b-desktop-launch.js";
+import { type PreparedRunArtifactPaths } from "./run-paths.js";
 export declare const RUN_BUNDLE_SCHEMA = "humanish.run-bundle.v1";
 export declare const SHARED_WORLD_SCHEMA = "humanish.shared-world.v1";
 export declare const REVIEW_SCHEMA = "humanish.review.v1";
@@ -593,9 +594,9 @@ export interface RunBundle {
      */
     adapterArtifacts?: RunAdapterArtifact[];
     /**
-     * Provider resources this run owns and may clean up later by exact recorded id.
-     * Optional + additive: absent means the producer did not record any run-owned
-     * remote resources. Core cleanup never enumerates provider accounts.
+     * Evidence about mutable provider resources observed during this run. Stored ids
+     * are not cleanup authority: automatic provider mutation requires a verified
+     * resource lease. Optional + additive; core never enumerates provider accounts.
      */
     providerResources?: RunProviderResource[];
 }
@@ -717,6 +718,7 @@ export interface CleanupResult {
     };
 }
 export interface RunCleanupHooks {
+    /** @deprecated Ignored. Stored provider ids are not authority to load or mutate a provider. */
     loadDesktopModule?: () => Promise<E2BDesktopModule>;
     cleanupAdapterResources?: (ctx: {
         cwd: string;
@@ -775,6 +777,14 @@ export declare function loadRunBundle(cwdInput: string, runInput: string): Promi
     bundlePath: string;
     runDir: string;
 } | null>;
+/** Internal continuity seam for callers that already bound one run identity. */
+export declare function loadRunBundlePrepared(cwdInput: string, runPaths: PreparedRunArtifactPaths): Promise<{
+    bundle: RunBundle;
+    bundlePath: string;
+    runDir: string;
+} | null>;
+/** Internal continuity seam for callers that already bound one run identity. */
+export declare function verifyRunPrepared(cwdInput: string, runInput: string, runPaths: PreparedRunArtifactPaths): Promise<VerifyResult>;
 export declare function listRuns(cwdInput: string): Promise<RunsResult>;
 export declare function readReview(cwdInput: string, runInput: string): Promise<VerifyResult | (ReviewSummary & {
     path: string;