humanish 0.104.3 → 0.106.0

package/dist/key-resolution.js

@@ -1,375 +0,0 @@
-// Provider-key discovery (#436): resolve the keys a live run needs through each vendor's
-// native chain instead of demanding a per-repo --env-file that operators hand-copy keys into.
-//
-// The chain, per key, FILL-ONLY (a rung never overrides anything already present):
-//   1. process env — including whatever --env-file just loaded (explicit always wins);
-//   2. `.humanish/local/provider.env` — the project-local overlay this CLI's own --help
-//      examples document;
-//   3. the OWNING vendor's native store, where one exists:
-//        E2B_API_KEY  <- ~/.e2b/config.json (written by `e2b auth login`);
-//        GH_TOKEN     <- `gh auth token` (the gh CLI's credential chain);
-//   4. the humanish user-level store `$XDG_CONFIG_HOME/humanish/keys.env`, written only by
-//      `humanish keys set` (0600, prompted or --stdin) — the fallback for vendors that ship
-//      no machine chain of their own (OpenAI, Anthropic).
-//
-// Every fill is ANNOUNCED by key name + source, never by value. The subject app's own
-// `.env`/`.env.local` are NEVER read — those hold product credentials, a different class
-// (#11); this module only reads humanish-owned files and vendor-owned stores.
-// `HUMANISH_STRICT_KEYS=1` disables every rung below process env (the pre-#436 behavior).
-import { spawn } from "node:child_process";
-import { chmodSync, closeSync, constants as fsConstants, existsSync, ftruncateSync, lstatSync, mkdirSync, openSync, readFileSync, writeSync } from "node:fs";
-import { homedir } from "node:os";
-import path from "node:path";
-import { loadEnvFile } from "./env-file.js";
-export const KEY_RESOLUTION_SCHEMA = "humanish.key-resolution.v1";
-/** The ONLY names implicit discovery may fill (and `humanish keys set` may store). Everything
- *  else in an overlay/store file is ignored-and-named: a repo-planted NODE_OPTIONS/LD_PRELOAD
- *  must never enter process env off a file the operator did not explicitly pass (an explicit
- *  --env-file remains the operator's own full-file load). Red-team finding, #436. */
-export const KNOWN_PROVIDER_KEYS = [
-    "OPENAI_API_KEY",
-    "ANTHROPIC_API_KEY",
-    "E2B_API_KEY",
-    "GH_TOKEN",
-    "GITHUB_TOKEN",
-    "CODEX_API_KEY",
-    "AGENTMAIL_API_KEY"
-];
-const PROVIDER_KEY_SET = new Set(KNOWN_PROVIDER_KEYS);
-/** `humanish keys set <vendor>` aliases; a raw ENV_NAME is also accepted. */
-export const KEY_VENDOR_ALIASES = {
-    openai: "OPENAI_API_KEY",
-    e2b: "E2B_API_KEY",
-    anthropic: "ANTHROPIC_API_KEY",
-    github: "GH_TOKEN",
-    agentmail: "AGENTMAIL_API_KEY"
-};
-export const PROJECT_OVERLAY_RELATIVE = path.join(".humanish", "local", "provider.env");
-export function userKeyStorePath(env, deps = {}) {
-    const home = deps.homeDir ?? homedir();
-    const declared = env.XDG_CONFIG_HOME?.trim();
-    // The XDG spec: a relative XDG_CONFIG_HOME MUST be ignored. Honoring one would make the
-    // key store cwd-relative — `humanish keys set` would write a secret into the current repo.
-    const configHome = declared !== undefined && declared !== "" && path.isAbsolute(declared) ? declared : path.join(home, ".config");
-    return path.join(configHome, "humanish", "keys.env");
-}
-function e2bConfigPath(deps) {
-    return path.join(deps.homeDir ?? homedir(), ".e2b", "config.json");
-}
-/** Default exec: bounded, quiet, stdin closed; null on ANY failure. Never throws. */
-function defaultExecText(command, args, timeoutMs) {
-    return new Promise((resolve) => {
-        let child;
-        try {
-            child = spawn(command, args, { stdio: ["ignore", "pipe", "ignore"] });
-        }
-        catch {
-            resolve(null);
-            return;
-        }
-        let out = "";
-        let settled = false;
-        const settle = (value) => {
-            if (!settled) {
-                settled = true;
-                resolve(value);
-            }
-        };
-        const timer = setTimeout(() => {
-            try {
-                child.kill();
-            }
-            catch {
-                // best effort
-            }
-            settle(null);
-        }, timeoutMs);
-        timer.unref?.();
-        child.stdout?.on("data", (chunk) => {
-            out += chunk.toString("utf8");
-        });
-        child.on("error", () => settle(null));
-        child.on("close", (code) => {
-            clearTimeout(timer);
-            if (code !== 0) {
-                settle(null);
-                return;
-            }
-            const trimmed = out.trim();
-            settle(trimmed.length > 0 && !trimmed.includes("\n") ? trimmed : null);
-        });
-    });
-}
-/** Read the E2B team key from the e2b CLI's own config. Defensive on shape: accept the
- *  documented `teamApiKey`, fall back to `apiKey`; anything else is a miss, never an error. */
-function readE2bConfigKey(deps) {
-    try {
-        const raw = readFileSync(e2bConfigPath(deps), "utf8");
-        const parsed = JSON.parse(raw);
-        if (parsed === null || typeof parsed !== "object")
-            return null;
-        const record = parsed;
-        for (const field of ["teamApiKey", "apiKey"]) {
-            const value = record[field];
-            if (typeof value === "string" && value.trim().length > 0)
-                return value.trim();
-        }
-        return null;
-    }
-    catch {
-        return null;
-    }
-}
-/** Refuse to READ a store through a symlink: a repo-local overlay that is secretly a link to
- *  an unrelated file is exactly the retargeting shape the artifact paths refuse elsewhere. */
-function isRegularFile(filePath) {
-    try {
-        return lstatSync(filePath).isFile();
-    }
-    catch {
-        return false;
-    }
-}
-/**
- * Fill missing provider keys into `env` from the discovery chain, announcing each fill as
- * `NAME from SOURCE`. Returns the fills. Opt-out: HUMANISH_STRICT_KEYS=1 returns [] untouched.
- */
-export async function discoverProviderKeys(args) {
-    const { cwd, env, announce } = args;
-    const deps = args.deps ?? {};
-    if (env.HUMANISH_STRICT_KEYS?.trim() === "1")
-        return [];
-    const fills = [];
-    const ignored = [];
-    // Fill-only means PRESENCE wins, including an explicitly-set empty value: an operator who
-    // exported OPENAI_API_KEY="" said "off", and a rung that "fixes" that has overridden them
-    // (red-team finding). Only a truly-unset name is fillable.
-    const fillable = (name) => env[name] === undefined;
-    const fill = (name, value, source) => {
-        env[name] = value;
-        fills.push({ name, source });
-    };
-    // Rung 2: the documented project-local overlay. Parsed ATOMICALLY against a scratch env so a
-    // file loadEnvFile rejects can never half-apply (red-team finding: earlier lines used to land
-    // in env unannounced before the parse error aborted). Only allowlisted provider names cross
-    // from the file into the real env.
-    const overlayPath = path.resolve(cwd, PROJECT_OVERLAY_RELATIVE);
-    if (isRegularFile(overlayPath) && !dirIsSymlink(overlayPath)) {
-        const scratch = {};
-        const overlay = await loadEnvFile(cwd, PROJECT_OVERLAY_RELATIVE, scratch);
-        if (overlay.ok) {
-            for (const name of overlay.loaded) {
-                const value = scratch[name];
-                if (value === undefined || !fillable(name))
-                    continue;
-                if (!PROVIDER_KEY_SET.has(name)) {
-                    ignored.push(`${name} (${PROJECT_OVERLAY_RELATIVE})`);
-                    continue;
-                }
-                fill(name, value, PROJECT_OVERLAY_RELATIVE);
-            }
-        }
-    }
-    // Rung 3a: the e2b CLI's own login store.
-    if (fillable("E2B_API_KEY")) {
-        const teamKey = readE2bConfigKey(deps);
-        if (teamKey !== null)
-            fill("E2B_API_KEY", teamKey, "~/.e2b/config.json (e2b auth login)");
-    }
-    // Rung 3b: the gh CLI's credential chain. Only consulted when NEITHER GitHub env name is
-    // present; fills GH_TOKEN (the name humanish reads first).
-    if (fillable("GH_TOKEN") && fillable("GITHUB_TOKEN")) {
-        const exec = deps.execText ?? defaultExecText;
-        const token = await exec("gh", ["auth", "token"], 3_000);
-        if (token !== null)
-            fill("GH_TOKEN", token, "gh auth token");
-    }
-    // Rung 4: the humanish user-level store — read with the SAME lenient parser `keys set`/`list`
-    // use, so one hand-mangled line degrades to that line alone instead of silently voiding the
-    // whole store (red-team finding: the strict parser disagreed with the store's own reader).
-    const storePath = userKeyStorePath(env, deps);
-    if (isRegularFile(storePath) && !dirIsSymlink(storePath)) {
-        for (const [name, value] of readStoreEntries(storePath)) {
-            if (!fillable(name))
-                continue;
-            if (!PROVIDER_KEY_SET.has(name)) {
-                ignored.push(`${name} (${storeLabel(env, deps)})`);
-                continue;
-            }
-            fill(name, value, storeLabel(env, deps));
-        }
-    }
-    for (const fill_ of fills)
-        announce(`humanish keys: ${fill_.name} from ${fill_.source}`);
-    for (const name of ignored)
-        announce(`humanish keys: ignored non-provider name ${name} — implicit discovery fills provider keys only; pass the file via --env-file to load everything in it`);
-    return fills;
-}
-/** True when the file's PARENT directory is (or traverses) a symlink at its last component —
- *  the dir-level retarget that defeats a file-level lstat check (red-team finding). */
-function dirIsSymlink(filePath) {
-    try {
-        return lstatSync(path.dirname(filePath)).isSymbolicLink();
-    }
-    catch {
-        return false;
-    }
-}
-function storeLabel(env, deps) {
-    const home = deps.homeDir ?? homedir();
-    return userKeyStorePath(env, deps).replace(home, "~");
-}
-/** The nearest fill instruction for a missing key — used by doctor rows and appended to
- *  *_KEYS_MISSING errors so the failure names the fix, not just the absence (#436). */
-export function missingKeyHint(name) {
-    switch (name) {
-        case "E2B_API_KEY":
-            return "run `e2b auth login`, or `humanish keys set e2b`";
-        case "GH_TOKEN":
-        case "GITHUB_TOKEN":
-            return "run `gh auth login`, or `humanish keys set github`";
-        case "OPENAI_API_KEY":
-            return "run `humanish keys set openai`";
-        case "ANTHROPIC_API_KEY":
-            return "run `humanish keys set anthropic`";
-        default:
-            return `run \`humanish keys set ${name}\``;
-    }
-}
-/** One shared suffix for *_KEYS_MISSING messages: where discovery looked, and what fills each
- *  missing key. Pure text; never values. */
-export function describeMissingKeys(names, env) {
-    const hints = names.map((name) => `${name}: ${missingKeyHint(name)}`).join("; ");
-    const strict = env.HUMANISH_STRICT_KEYS?.trim() === "1";
-    const chain = strict
-        ? "key discovery is disabled (HUMANISH_STRICT_KEYS=1); only process env and --env-file are read"
-        : `also checked ${PROJECT_OVERLAY_RELATIVE}, ~/.e2b/config.json, gh auth token, and ${path.join("~", ".config", "humanish", "keys.env")}`;
-    return `${chain}. Fill: ${hints}.`;
-}
-/**
- * Non-mutating probe for doctor: report, per key, the source that currently supplies it.
- * Runs the same chain against a scratch copy of env so nothing observable changes.
- */
-export async function probeKeySources(names, args) {
-    const scratch = { ...args.env };
-    const fills = await discoverProviderKeys({
-        cwd: args.cwd,
-        env: scratch,
-        announce: () => { },
-        ...(args.deps === undefined ? {} : { deps: args.deps })
-    });
-    const bySource = new Map(fills.map((fill) => [fill.name, fill.source]));
-    return names.map((name) => {
-        const inEnv = args.env[name] !== undefined && args.env[name]?.trim() !== "";
-        // GH_TOKEN and GITHUB_TOKEN are one credential with two spellings; a doctor row that says
-        // "missing" while GITHUB_TOKEN sits in the env would be wrong (red-team nit).
-        const aliasInEnv = name === "GH_TOKEN" && args.env.GITHUB_TOKEN !== undefined && args.env.GITHUB_TOKEN.trim() !== "";
-        const source = inEnv ? "process env" : aliasInEnv ? "process env (GITHUB_TOKEN)" : (bySource.get(name) ?? null);
-        return { name, source, hint: missingKeyHint(name) };
-    });
-}
-const ENV_NAME = /^[A-Za-z_][A-Za-z0-9_]*$/;
-/** Resolve a `humanish keys set` target: a vendor alias or a raw env name. Null = invalid. */
-export function resolveKeyName(vendorOrName) {
-    const alias = KEY_VENDOR_ALIASES[vendorOrName.toLowerCase()];
-    if (alias !== undefined)
-        return alias;
-    return ENV_NAME.test(vendorOrName) ? vendorOrName : null;
-}
-/** Write one key into the user store (0700 dir, 0600 file). Only allowlisted provider names
- *  are storable (the store feeds implicit discovery — an arbitrary-name store would be an env
- *  injection vector with extra steps). The value must be a single non-empty line that
- *  round-trips the store's own parser byte-identically, and the write refuses symlinks at the
- *  file AND its parent directory (red-team findings). */
-export function setUserKey(name, value, env, deps = {}) {
-    const trimmed = value.trim();
-    if (trimmed.length === 0 || /[\u0000-\u001f\u007f]/.test(trimmed)) {
-        throw new Error("The key value must be a single non-empty line without control characters.");
-    }
-    if (!ENV_NAME.test(name)) {
-        throw new Error(`Not a valid env name: ${name}`);
-    }
-    if (!PROVIDER_KEY_SET.has(name)) {
-        throw new Error(`The store holds provider keys only (${[...PROVIDER_KEY_SET].join(", ")}). For anything else, use an explicit --env-file.`);
-    }
-    const storePath = userKeyStorePath(env, deps);
-    const dir = path.dirname(storePath);
-    mkdirSync(dir, { recursive: true, mode: 0o700 });
-    if (lstatSync(dir).isSymbolicLink()) {
-        throw new Error(`Refusing to write through a symlinked store directory: ${dir}`);
-    }
-    if (existsSync(storePath) && !lstatSync(storePath).isFile()) {
-        throw new Error(`Refusing to write the store: ${storePath} is not a regular file.`);
-    }
-    const entries = readStoreEntries(storePath);
-    entries.set(name, trimmed);
-    // The written line must read back byte-identically through the store's own parser: a value
-    // that parses differently (an embedded '#', a leading quote the env parser would strip)
-    // would silently resolve to a DIFFERENT secret on the next run.
-    const roundTrip = parseStoreLine(`${name}=${trimmed}`);
-    if (roundTrip === null || roundTrip[0] !== name || roundTrip[1] !== trimmed) {
-        throw new Error("The value does not round-trip the store format (avoid leading quotes and '#'); pass it via --env-file instead.");
-    }
-    writeStore(storePath, entries);
-    return { path: storePath };
-}
-/** Remove one key from the user store. Returns whether it was present. */
-export function unsetUserKey(name, env, deps = {}) {
-    const storePath = userKeyStorePath(env, deps);
-    if (!isRegularFile(storePath) || dirIsSymlink(storePath))
-        return false;
-    const entries = readStoreEntries(storePath);
-    const had = entries.delete(name);
-    if (had)
-        writeStore(storePath, entries);
-    return had;
-}
-/** The names (never values) currently in the user store. */
-export function listUserKeys(env, deps = {}) {
-    const storePath = userKeyStorePath(env, deps);
-    if (!isRegularFile(storePath) || dirIsSymlink(storePath))
-        return [];
-    return [...readStoreEntries(storePath).keys()];
-}
-function readStoreEntries(storePath) {
-    const entries = new Map();
-    if (!existsSync(storePath))
-        return entries;
-    const text = readFileSync(storePath, "utf8");
-    for (const line of text.split(/\r?\n/)) {
-        const parsed = parseStoreLine(line);
-        if (parsed !== null)
-            entries.set(parsed[0], parsed[1]);
-    }
-    return entries;
-}
-function writeStore(storePath, entries) {
-    const body = [...entries.entries()].map(([name, value]) => `${name}=${value}`).join("\n");
-    const text = body.length > 0 ? `${body}\n` : "";
-    // O_NOFOLLOW: a symlinked keys.env must never carry the write to its target (red-team
-    // reproduced writing a secret through the link into an attacker-chosen file).
-    const fd = openSync(storePath, fsConstants.O_WRONLY | fsConstants.O_CREAT | fsConstants.O_NOFOLLOW, 0o600);
-    try {
-        ftruncateSync(fd, 0);
-        writeSync(fd, text, 0, "utf8");
-    }
-    finally {
-        closeSync(fd);
-    }
-    // mkdir/open modes are masked by umask; enforce the final bits explicitly.
-    chmodSync(storePath, 0o600);
-}
-/** The store's line grammar, shared by read and the set-time round-trip check. */
-function parseStoreLine(line) {
-    const trimmed = line.trim();
-    if (trimmed === "" || trimmed.startsWith("#"))
-        return null;
-    const separator = trimmed.indexOf("=");
-    if (separator <= 0)
-        return null;
-    const name = trimmed.slice(0, separator).trim();
-    if (!ENV_NAME.test(name))
-        return null;
-    return [name, trimmed.slice(separator + 1).trim()];
-}
-//# sourceMappingURL=key-resolution.js.map

package/dist/key-resolution.js.map

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

package/dist/lab-app-runner.d.ts

@@ -1,78 +0,0 @@
-export declare const LAB_APP_RUNNER_PLAN_SCHEMA = "humanish.lab-app-runner-plan.v1";
-export type LabAppFramework = "next" | "vite" | "generic" | "none";
-export type LabPackageManager = "npm" | "pnpm" | "yarn" | "bun";
-export type LabInstallMode = "run" | "skip" | "when-missing";
-export type LabSurfaceKind = "desktop" | "mobile";
-export interface LabPackageJsonMetadata {
-    dependencies?: Record<string, string>;
-    devDependencies?: Record<string, string>;
-    packageManager?: string;
-    scripts?: Record<string, string>;
-}
-export interface LabAppRunnerMetadata {
-    dependencies?: Record<string, string>;
-    devDependencies?: Record<string, string>;
-    hasNodeModules?: boolean;
-    lockfiles?: string[];
-    packageJson?: LabPackageJsonMetadata;
-    packageManager?: string;
-    preferredPort?: number;
-    readinessIntervalMs?: number;
-    readinessTimeoutMs?: number;
-    scripts?: Record<string, string>;
-}
-export interface LabAppRunnerInstallPlan {
-    command: string;
-    mode: LabInstallMode;
-    reason: string;
-}
-export interface LabAppRunnerDevServerPlan {
-    command: string;
-    framework: Exclude<LabAppFramework, "none">;
-    port: number;
-    reason: string;
-    scriptName: string;
-    url: string;
-}
-export interface LabAppRunnerReadinessPlan {
-    command: string;
-    intervalMs: number;
-    timeoutMs: number;
-    url: string;
-}
-export interface LabAppSurface {
-    command: string;
-    id: LabSurfaceKind;
-    label: string;
-    url: string;
-    viewport: {
-        deviceScaleFactor: number;
-        height: number;
-        isMobile: boolean;
-        width: number;
-    };
-}
-export interface LabAppRunnerShellPlan {
-    commands: string[];
-    script: string;
-}
-export interface LabAppRunnerPlan {
-    devServer?: LabAppRunnerDevServerPlan;
-    framework: LabAppFramework;
-    install: LabAppRunnerInstallPlan;
-    ok: boolean;
-    packageManager: LabPackageManager;
-    readiness?: LabAppRunnerReadinessPlan;
-    schema: typeof LAB_APP_RUNNER_PLAN_SCHEMA;
-    shell: LabAppRunnerShellPlan;
-    surfaces: LabAppSurface[];
-    warnings: string[];
-}
-export declare function buildLabAppRunnerPlan(metadata: LabAppRunnerMetadata): LabAppRunnerPlan;
-export declare function renderLabAppRunnerShell(args: {
-    devServer?: LabAppRunnerDevServerPlan;
-    install: LabAppRunnerInstallPlan;
-    packageManager: LabPackageManager;
-    readiness?: LabAppRunnerReadinessPlan;
-    surfaces?: LabAppSurface[];
-}): LabAppRunnerShellPlan;