nawabari 0.9.2 → 0.10.2

package/dist/domain/runtime-provider-pnpm-middleware.js

@@ -0,0 +1,316 @@
+import fs from "node:fs";
+import path from "node:path";
+import { DomainError, failure, success } from "./errors.js";
+import { createRuntimeFile, inspectRuntimeFile } from "./runtime-file-identity.js";
+import { REAL_PNPM_BACKEND_PROVIDER, REAL_PNPM_BACKEND_REQUIREMENT, RTK_BACKEND_PROVIDER, RTK_BACKEND_REQUIREMENT, } from "./pnpm-middleware-backend-materialization.js";
+import { CANONICAL_EXECUTABLE_ROOT, compileRuntimeExecutableProjection } from "./runtime-executable-projection.js";
+import { runtimeMaterializationMissingError, runtimeProviderMissingError, validateSessionRuntimeProjection, } from "./runtime-projection.js";
+/** The stable projected entrypoint supplied by this concrete provider. */
+export const PROJECTED_PNPM_ENTRYPOINT = "pnpm";
+export const PROJECTED_PNPM_TARGET = `${CANONICAL_EXECUTABLE_ROOT}/${PROJECTED_PNPM_ENTRYPOINT}`;
+/** The one namespace file used as the launcher backing source. */
+export const PNPM_MIDDLEWARE_LAUNCHER_TARGET = "/runtime/pnpm-middleware/pnpm-launcher";
+export const PNPM_MIDDLEWARE_LAUNCHER_NODE_TARGET = `${CANONICAL_EXECUTABLE_ROOT}/node`;
+/** The launcher provider is owned here; backend provider identities come from #311. */
+export const PNPM_MIDDLEWARE_PROVIDER_IDS = Object.freeze({
+    launcher: "rtk-pnpm-launcher",
+});
+/** The command supported by the pinned RTK adapter. */
+export const PINNED_RTK_BACKEND_BINDING = "proxy";
+function invalid(field, reason, value) {
+    return failure(new DomainError("RUNTIME_PROJECTION_INVALID", `pnpm middleware field '${field}' is invalid: ${reason}.`, {
+        field,
+        ...(value === undefined ? {} : { value }),
+    }));
+}
+function ambiguous(field, reason, value) {
+    return failure(new DomainError("RUNTIME_PROJECTION_AMBIGUOUS", `pnpm middleware field '${field}' is ambiguous: ${reason}.`, {
+        field,
+        value,
+    }));
+}
+function materializationMissing(requirement, reason, source) {
+    const canonical = runtimeMaterializationMissingError(requirement.id, requirement.kind);
+    return failure(new DomainError(canonical.code, `${canonical.message.slice(0, -1)}: ${reason}.`, {
+        ...(canonical.details ?? {}),
+        reason,
+        ...(source === undefined ? {} : { source }),
+    }, canonical.exitCode));
+}
+function isCanonicalAbsolute(value) {
+    return (value.length > 0 &&
+        path.posix.isAbsolute(value) &&
+        !value.includes("\0") &&
+        path.posix.normalize(value) === value &&
+        value !== "/");
+}
+function isProjectedPath(value) {
+    return value === CANONICAL_EXECUTABLE_ROOT || value.startsWith(`${CANONICAL_EXECUTABLE_ROOT}/`);
+}
+function validateExactPath(value, field) {
+    if (typeof value !== "string" || !isCanonicalAbsolute(value)) {
+        return invalid(field, "expected a normalized absolute path", typeof value === "string" ? value : undefined);
+    }
+    if (isProjectedPath(value))
+        return invalid(field, "the canonical executable surface cannot be a backend", value);
+    return success(value);
+}
+function validateBackendFile(source, field, requirement) {
+    try {
+        inspectRuntimeFile(source, (_descriptor, stat) => {
+            if ((stat.mode & 73n) === 0n)
+                throw new Error("not executable");
+            return undefined;
+        }, { requireCanonicalPath: true });
+    }
+    catch (error) {
+        if (error instanceof Error && error.message.includes("symlink")) {
+            return invalid(field, "the backend must not be a symlink", source);
+        }
+        return materializationMissing(requirement, "the backend is missing, not regular, or cannot be inspected", source);
+    }
+    return success(null);
+}
+function validateProvider(value, expected, field) {
+    if (typeof value !== "object" ||
+        value === null ||
+        typeof value.id !== "string" ||
+        typeof value.requirement_id !== "string") {
+        return invalid(field, "expected a provider identity");
+    }
+    const provider = value;
+    if (provider.id !== expected.id || provider.requirement_id !== expected.requirement_id) {
+        return invalid(field, "provider identity does not match the fixed adapter requirement", provider.id);
+    }
+    return success(null);
+}
+function requirementFor(projection, requirement) {
+    const selected = projection.requirements.find((candidate) => candidate.id === requirement.id);
+    if (selected === undefined)
+        return materializationMissing(requirement, "the adapter requirement was not selected");
+    if (selected.kind !== requirement.kind ||
+        selected.name !== requirement.name ||
+        selected.version !== requirement.version) {
+        return invalid("requirements", "the selected adapter requirement does not match the pinned backend evidence", selected.id);
+    }
+    return success(selected);
+}
+function hasExactReadOnlyMaterialization(projection, source, target) {
+    return projection.filesystem.some((entry) => entry.source === source && entry.target === target && entry.access_mode === "read-only");
+}
+function validateBackend(projection, backend, requirement, field, expectedProvider) {
+    if (typeof backend !== "object" || backend === null)
+        return invalid(field, "expected an exact backend descriptor");
+    const candidate = backend;
+    const target = validateExactPath(candidate.path, `${field}.path`);
+    if (!target.ok)
+        return target;
+    const source = validateExactPath(candidate.source, `${field}.source`);
+    if (!source.ok)
+        return source;
+    const provider = validateProvider(candidate.provider, expectedProvider, `${field}.provider`);
+    if (!provider.ok)
+        return provider;
+    const selected = requirementFor(projection, requirement);
+    if (!selected.ok)
+        return selected;
+    const materialized = validateBackendFile(source.value, `${field}.source`, requirement);
+    if (!materialized.ok)
+        return materialized;
+    if (!hasExactReadOnlyMaterialization(projection, source.value, target.value)) {
+        return materializationMissing(selected.value, "no exact read-only source-to-target materialization exists", source.value);
+    }
+    return success(Object.freeze({
+        path: target.value,
+        source: source.value,
+        provider: candidate.provider,
+    }));
+}
+/**
+ * The launcher's shebang is a hard, undeclared dependency on a canonical
+ * `node` entrypoint. Confirm the incoming projection declares and resolves
+ * a `node` executable at `PNPM_MIDDLEWARE_LAUNCHER_NODE_TARGET` through the
+ * same strict compiler used for the executable surface, before this adapter
+ * ever writes a launcher whose interpreter may not exist inside the sandbox.
+ */
+function validateNodeInterpreter(projection) {
+    const entrypoint = projection.executables.find((candidate) => candidate.name === "node");
+    if (entrypoint === undefined) {
+        return failure(runtimeProviderMissingError("node", "node", "node-runtime"));
+    }
+    const compiled = compileRuntimeExecutableProjection(projection);
+    if (!compiled.ok)
+        return compiled;
+    const resolved = compiled.value.find((entry) => entry.target === PNPM_MIDDLEWARE_LAUNCHER_NODE_TARGET);
+    if (resolved === undefined) {
+        return failure(runtimeProviderMissingError(entrypoint.provider.id, entrypoint.name, entrypoint.provider.requirement_id));
+    }
+    return success(null);
+}
+function validateLauncherPath(value, backendSources, projection) {
+    if (typeof value !== "string" || !isCanonicalAbsolute(value)) {
+        return invalid("launcher_path", "expected a normalized absolute path", typeof value === "string" ? value : undefined);
+    }
+    if (isProjectedPath(value))
+        return invalid("launcher_path", "the launcher cannot be written in the projected surface", value);
+    if (backendSources.includes(value))
+        return ambiguous("launcher_path", "the launcher would overwrite a backend", value);
+    for (const entry of projection.filesystem) {
+        if (entry.source === value || entry.source.startsWith(`${value}/`) || value.startsWith(`${entry.source}/`)) {
+            return invalid("launcher_path", "the launcher cannot overlap an existing materialization", value);
+        }
+    }
+    const parent = path.posix.dirname(value);
+    try {
+        if (fs.realpathSync.native(parent) !== parent)
+            return invalid("launcher_path", "the parent is not canonical", parent);
+    }
+    catch {
+        return materializationMissing(REAL_PNPM_BACKEND_REQUIREMENT, "the launcher parent is unavailable", parent);
+    }
+    try {
+        fs.lstatSync(value);
+        return ambiguous("launcher_path", "the launcher destination already exists", value);
+    }
+    catch (error) {
+        if (error.code !== "ENOENT") {
+            return invalid("launcher_path", "the launcher destination cannot be inspected", value);
+        }
+    }
+    return success(value);
+}
+function renderLauncher(rtkPath, realPnpmPath) {
+    return `#!${PNPM_MIDDLEWARE_LAUNCHER_NODE_TARGET}
+import { spawn } from "node:child_process";
+import process from "node:process";
+
+const rtkPath = ${JSON.stringify(rtkPath)};
+const realPnpmPath = ${JSON.stringify(realPnpmPath)};
+const child = spawn(rtkPath, ["${PINNED_RTK_BACKEND_BINDING}", realPnpmPath, ...process.argv.slice(2)], {
+  cwd: process.cwd(),
+  env: process.env,
+  shell: false,
+  stdio: "inherit",
+});
+
+let childExited = false;
+let spawnFailed = false;
+const signals = ["SIGHUP", "SIGINT", "SIGTERM", "SIGQUIT"];
+const forwardSignal = (signal) => {
+  if (!childExited) child.kill(signal);
+};
+for (const signal of signals) process.on(signal, forwardSignal);
+
+child.once("error", (error) => {
+  spawnFailed = true;
+  process.exitCode = 127;
+  process.stderr.write("pnpm middleware could not start RTK: " + error.message.slice(0, 200) + "\\n");
+});
+child.once("close", (code, signal) => {
+  childExited = true;
+  for (const forwarded of signals) process.removeListener(forwarded, forwardSignal);
+  if (spawnFailed) return;
+  if (signal !== null) {
+    process.kill(process.pid, signal);
+    return;
+  }
+  process.exitCode = code ?? 127;
+});
+`;
+}
+function writeLauncher(source, content) {
+    try {
+        createRuntimeFile(source, (descriptor) => {
+            fs.writeFileSync(descriptor, content, { encoding: "utf8" });
+            fs.fchmodSync(descriptor, 0o755);
+            return undefined;
+        });
+        return success(null);
+    }
+    catch (error) {
+        return failure(new DomainError("RUNTIME_MATERIALIZATION_MISSING", `Runtime package requirement '${REAL_PNPM_BACKEND_REQUIREMENT.id}' was not materialized: the fixed launcher could not be written.`, {
+            requirement_id: REAL_PNPM_BACKEND_REQUIREMENT.id,
+            requirement_kind: REAL_PNPM_BACKEND_REQUIREMENT.kind,
+            reason: error instanceof Error ? error.message.slice(0, 200) : "unknown",
+            source,
+        }));
+    }
+}
+/**
+ * Materialize the one concrete executable provider owned by Issue #296.
+ *
+ * The returned projection is still consumed by #293's canonical executable
+ * compiler.  This function writes one launcher file and adds one file-level
+ * read-only projection; it never creates a directory projection or performs
+ * command discovery.
+ */
+export function materializePnpmMiddleware(input) {
+    if (typeof input !== "object" || input === null)
+        return invalid("materialization", "expected an object");
+    const candidate = input;
+    if (candidate.projection === undefined)
+        return invalid("projection", "is required");
+    const projection = candidate.projection;
+    const rtk = validateBackend(projection, candidate.rtk, RTK_BACKEND_REQUIREMENT, "rtk", RTK_BACKEND_PROVIDER);
+    if (!rtk.ok)
+        return rtk;
+    const realPnpm = validateBackend(projection, candidate.real_pnpm, REAL_PNPM_BACKEND_REQUIREMENT, "real_pnpm", REAL_PNPM_BACKEND_PROVIDER);
+    if (!realPnpm.ok)
+        return realPnpm;
+    if (rtk.value.path === realPnpm.value.path || rtk.value.source === realPnpm.value.source) {
+        return ambiguous("backends", "RTK and real pnpm cannot resolve to the same path", rtk.value.path);
+    }
+    if (rtk.value.path === realPnpm.value.source || rtk.value.source === realPnpm.value.path) {
+        return ambiguous("backends", "RTK and real pnpm cannot cross-resolve between host and sandbox paths", rtk.value.path);
+    }
+    const launcher = validateLauncherPath(candidate.launcher_path, [rtk.value.source, realPnpm.value.source], projection);
+    if (!launcher.ok)
+        return launcher;
+    const node = validateNodeInterpreter(projection);
+    if (!node.ok)
+        return node;
+    const projected = {
+        policy: projection.policy,
+        profile: projection.profile,
+        requirements: projection.requirements,
+        filesystem: [
+            ...projection.filesystem,
+            {
+                source: launcher.value,
+                target: PNPM_MIDDLEWARE_LAUNCHER_TARGET,
+                access_mode: "read-only",
+                provenance: "package",
+            },
+        ],
+        executables: [
+            ...projection.executables,
+            {
+                name: PROJECTED_PNPM_ENTRYPOINT,
+                target: PNPM_MIDDLEWARE_LAUNCHER_TARGET,
+                provider: {
+                    id: PNPM_MIDDLEWARE_PROVIDER_IDS.launcher,
+                    requirement_id: realPnpm.value.provider.requirement_id,
+                },
+                provenance: "package",
+            },
+        ],
+    };
+    const validated = validateProjectedPnpmProjection(projected);
+    if (!validated.ok)
+        return validated;
+    const written = writeLauncher(launcher.value, renderLauncher(rtk.value.path, realPnpm.value.path));
+    if (!written.ok)
+        return written;
+    return success(Object.freeze({
+        projection: validated.value,
+        launcher_source: launcher.value,
+        launcher_target: PNPM_MIDDLEWARE_LAUNCHER_TARGET,
+        executable_target: PROJECTED_PNPM_TARGET,
+        rtk_path: rtk.value.path,
+        real_pnpm_path: realPnpm.value.path,
+    }));
+}
+function validateProjectedPnpmProjection(input) {
+    return validateSessionRuntimeProjection(input);
+}
+//# sourceMappingURL=runtime-provider-pnpm-middleware.js.map

package/dist/domain/runtime-provider-pnpm-middleware.js.map

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

package/dist/domain/runtime-provider-tgrep.d.ts

@@ -0,0 +1,60 @@
+import { type DomainResult } from "./errors.js";
+import type { RuntimeExecutableProviderMaterialization } from "./runtime-executable-projection.js";
+import { type SessionRuntimeProjection } from "./runtime-projection.js";
+import { type TgrepRuntimeMaterialization } from "./tgrep-runtime-materialization.js";
+/** Versioned identity for the public projected rg adapter. */
+export declare const TGREP_RG_PROVIDER_CONTRACT_ID: "nawabari.tgrep-rg-provider.v1";
+export declare const TGREP_RG_PROVIDER_SCHEMA_VERSION: 1;
+export declare const TGREP_RG_COMPATIBILITY_CONTRACT_ID: "nawabari.tgrep-rg-compatibility.v1";
+export declare const TGREP_RG_COMPATIBILITY_SCHEMA_VERSION: 1;
+/** The only public name supplied by this provider. There is deliberately no grep alias. */
+export declare const TGREP_RG_ENTRYPOINT_NAME: "rg";
+export declare const TGREP_RG_ADAPTER_TARGET: "/runtime/tgrep-rg-adapter/rg";
+export declare const TGREP_RG_PROVIDER: Readonly<{
+    id: "tgrep-rg-provider";
+    requirement_id: string;
+}>;
+export type TgrepRgCompatibilityEntry = Readonly<{
+    readonly id: string;
+    readonly status: "supported" | "rejected";
+    readonly rg: readonly string[];
+    readonly backend: readonly string[];
+    readonly value: "none" | "required";
+    readonly conflict_group?: string;
+}>;
+/**
+ * Closed compatibility authority. Every supported spelling has one canonical
+ * backend transformation; all other spellings are rejected before spawn.
+ */
+export declare const TGREP_RG_COMPATIBILITY_MATRIX: readonly TgrepRgCompatibilityEntry[];
+export type TgrepRgTranslation = Readonly<{
+    readonly argv: readonly string[];
+    readonly options: readonly string[];
+    readonly positionals: readonly string[];
+    readonly files_mode: boolean;
+}>;
+/** Translate one raw rg argv using only the closed compatibility matrix. */
+export declare function translateTgrepRgArguments(argv: readonly string[]): DomainResult<TgrepRgTranslation>;
+export type TgrepRgProviderMaterialization = Readonly<{
+    readonly contract_id: typeof TGREP_RG_PROVIDER_CONTRACT_ID;
+    readonly schema_version: typeof TGREP_RG_PROVIDER_SCHEMA_VERSION;
+    readonly compatibility_contract_id: typeof TGREP_RG_COMPATIBILITY_CONTRACT_ID;
+    readonly compatibility_schema_version: typeof TGREP_RG_COMPATIBILITY_SCHEMA_VERSION;
+    readonly backend_source: string;
+    readonly node_source: string;
+    readonly adapter_source: string;
+    readonly adapter_target: typeof TGREP_RG_ADAPTER_TARGET;
+    readonly provider: typeof TGREP_RG_PROVIDER;
+    readonly provider_materialization: RuntimeExecutableProviderMaterialization;
+    readonly projection: SessionRuntimeProjection;
+}>;
+/**
+ * Generate the concrete launcher artifact and feed it into #293's existing
+ * filesystem/executable projection. The supplied #308 materialization is the
+ * sole source of the tgrep backend and is never re-resolved here.
+ */
+export declare function materializeTgrepRgProvider(materialization: TgrepRuntimeMaterialization, options: Readonly<{
+    readonly artifact_root: string;
+}>): DomainResult<TgrepRgProviderMaterialization>;
+export declare const materializeTgrepRgRuntime: typeof materializeTgrepRgProvider;
+export declare const projectTgrepRgRuntime: typeof materializeTgrepRgProvider;