humanish 0.0.1 → 0.15.1

package/dist/init.js

@@ -0,0 +1,429 @@
+import { lstat, realpath, stat } from "node:fs/promises";
+import path from "node:path";
+import { humanishScripts, runtimeDirectories, starterFiles } from "./init-templates.js";
+import { assertPreparedSelectedOutputDirectory, prepareContainedOutputDirectory, prepareSelectedOutputDirectory, readContainedRegularFile, writeContainedOutputFile } from "./selected-output-paths.js";
+export const INIT_RESPONSE_SCHEMA = "humanish.init-result.v1";
+export async function runInit(options) {
+    const requestedCwd = path.resolve(options.cwd);
+    const mode = getMode(options);
+    const warnings = [];
+    const changes = [];
+    const writes = [];
+    const dirs = [];
+    const cwdCheck = await validateCwd(requestedCwd);
+    if (cwdCheck) {
+        return {
+            schema: INIT_RESPONSE_SCHEMA,
+            ok: false,
+            mode,
+            cwd: requestedCwd,
+            changes,
+            warnings,
+            error: cwdCheck
+        };
+    }
+    const cwd = await realpath(requestedCwd);
+    const preparedProjectRoot = await prepareSelectedOutputDirectory(path.dirname(cwd), cwd);
+    const initialPathCheck = await validateInitProjectPaths(cwd);
+    if (initialPathCheck) {
+        return {
+            schema: INIT_RESPONSE_SCHEMA,
+            ok: false,
+            mode,
+            cwd: requestedCwd,
+            changes,
+            warnings,
+            error: initialPathCheck
+        };
+    }
+    for (const file of starterFiles) {
+        const absolutePath = path.join(cwd, file.path);
+        const existing = await readTextIfExists(preparedProjectRoot, file.path);
+        if (existing === null) {
+            changes.push({
+                path: file.path,
+                action: "create",
+                target: file.plane,
+                reason: "public-safe starter file"
+            });
+            writes.push({
+                absolutePath,
+                relativePath: file.path,
+                contents: file.contents,
+                target: file.plane
+            });
+        }
+        else if (existing === file.contents) {
+            changes.push({
+                path: file.path,
+                action: "skip",
+                target: file.plane,
+                reason: "already matches starter"
+            });
+        }
+        else {
+            changes.push({
+                path: file.path,
+                action: "skip",
+                target: file.plane,
+                reason: "existing file would not be overwritten"
+            });
+            warnings.push(`Skipped existing ${file.path}; Humanish never overwrites user files during init.`);
+        }
+    }
+    for (const directory of runtimeDirectories) {
+        const absolutePath = path.join(cwd, directory.path);
+        const exists = await pathExists(preparedProjectRoot, directory.path);
+        changes.push({
+            path: directory.path,
+            action: exists ? "skip" : "mkdir",
+            target: directory.plane,
+            reason: exists ? "already exists" : "ignored runtime directory"
+        });
+        if (!exists) {
+            dirs.push({ absolutePath, relativePath: directory.path });
+        }
+    }
+    const gitignorePlan = await planGitignore(preparedProjectRoot, cwd);
+    changes.push(gitignorePlan.change);
+    if (gitignorePlan.write) {
+        writes.push(gitignorePlan.write);
+    }
+    const packagePlan = await planPackageJson(preparedProjectRoot, cwd);
+    changes.push(packagePlan.change);
+    warnings.push(...packagePlan.warnings);
+    if (packagePlan.error) {
+        return {
+            schema: INIT_RESPONSE_SCHEMA,
+            ok: false,
+            mode,
+            cwd: requestedCwd,
+            changes,
+            warnings,
+            error: packagePlan.error
+        };
+    }
+    if (packagePlan.write) {
+        writes.push(packagePlan.write);
+    }
+    if (mode === "needs-confirmation") {
+        return {
+            schema: INIT_RESPONSE_SCHEMA,
+            ok: false,
+            mode,
+            cwd: requestedCwd,
+            changes,
+            warnings,
+            error: {
+                code: "HUMANISH_CONFIRMATION_REQUIRED",
+                message: "Re-run with --dry-run to inspect or --yes to apply safe generated changes."
+            }
+        };
+    }
+    if (mode === "applied") {
+        await assertPreparedSelectedOutputDirectory(preparedProjectRoot);
+        const applyPathCheck = await validateInitProjectPaths(cwd);
+        if (applyPathCheck) {
+            return {
+                schema: INIT_RESPONSE_SCHEMA,
+                ok: false,
+                mode,
+                cwd: requestedCwd,
+                changes,
+                warnings,
+                error: applyPathCheck
+            };
+        }
+        for (const directory of dirs) {
+            await prepareContainedOutputDirectory(preparedProjectRoot, directory.relativePath);
+        }
+        for (const write of writes) {
+            await writeContainedOutputFile(preparedProjectRoot, write.relativePath, write.contents, "utf8");
+        }
+    }
+    return {
+        schema: INIT_RESPONSE_SCHEMA,
+        ok: true,
+        mode,
+        cwd: requestedCwd,
+        changes,
+        warnings
+    };
+}
+async function validateInitProjectPaths(cwd) {
+    const targets = [
+        ...starterFiles.map((file) => ({ path: file.path, kind: "file" })),
+        ...runtimeDirectories.map((directory) => ({ path: directory.path, kind: "directory" })),
+        { path: ".gitignore", kind: "file" },
+        { path: "package.json", kind: "file" }
+    ];
+    for (const targetSpec of targets) {
+        const relativePath = targetSpec.path;
+        const target = path.resolve(cwd, relativePath);
+        if (!isPathInside(cwd, target)) {
+            return unsafeProjectPath(relativePath);
+        }
+        const parts = path.relative(cwd, target).split(path.sep).filter(Boolean);
+        let current = cwd;
+        for (const [index, part] of parts.entries()) {
+            current = path.join(current, part);
+            try {
+                const stats = await lstat(current);
+                const isLeaf = index === parts.length - 1;
+                if (stats.isSymbolicLink()
+                    || (!isLeaf && !stats.isDirectory())
+                    || (isLeaf && targetSpec.kind === "file" && (!stats.isFile() || stats.nlink > 1))
+                    || (isLeaf && targetSpec.kind === "directory" && !stats.isDirectory())) {
+                    return unsafeProjectPath(relativePath);
+                }
+            }
+            catch (error) {
+                if (isNodeError(error) && error.code === "ENOENT") {
+                    break;
+                }
+                return unsafeProjectPath(relativePath);
+            }
+        }
+    }
+    return null;
+}
+function unsafeProjectPath(relativePath) {
+    return {
+        code: "HUMANISH_UNSAFE_PROJECT_PATH",
+        message: `Init target must stay inside the project, use the expected regular-file or directory kind, and not traverse symbolic links or hardlinked files: ${relativePath}`
+    };
+}
+function getMode(options) {
+    if (options.dryRun) {
+        return "dry-run";
+    }
+    if (options.yes) {
+        return "applied";
+    }
+    return "needs-confirmation";
+}
+async function planGitignore(projectRoot, cwd) {
+    const relativePath = ".gitignore";
+    const absolutePath = path.join(cwd, relativePath);
+    const existing = await readTextIfExists(projectRoot, relativePath);
+    const currentLines = existing?.split(/\r?\n/) ?? [];
+    const envIndex = currentLines.lastIndexOf(".env*");
+    const envExampleIndex = currentLines.lastIndexOf("!.env.example");
+    const needsEnv = envIndex === -1;
+    const needsEnvExample = envExampleIndex === -1
+        || (envIndex !== -1 && envExampleIndex < envIndex)
+        || needsEnv;
+    const missingLines = [
+        ...(currentLines.includes(".humanish/") ? [] : [".humanish/"]),
+        ...(needsEnv ? [".env*"] : []),
+        ...(needsEnvExample ? ["!.env.example"] : [])
+    ];
+    if (missingLines.length === 0) {
+        return {
+            change: {
+                path: relativePath,
+                action: "skip",
+                target: "gitignore",
+                reason: "already ignores Humanish runtime and env files"
+            }
+        };
+    }
+    const prefix = existing && existing.trim().length > 0
+        ? trimTrailingNewlines(existing) + "\n\n"
+        : "";
+    const contents = `${prefix}# Humanish runtime and local secrets\n${missingLines.join("\n")}\n`;
+    return {
+        write: {
+            absolutePath,
+            relativePath,
+            contents,
+            target: "gitignore"
+        },
+        change: {
+            path: relativePath,
+            action: existing === null ? "create" : "update",
+            target: "gitignore",
+            reason: `add ${missingLines.join(", ")}`
+        }
+    };
+}
+async function planPackageJson(projectRoot, cwd) {
+    const relativePath = "package.json";
+    const absolutePath = path.join(cwd, relativePath);
+    const existing = await readTextIfExists(projectRoot, relativePath);
+    if (existing === null) {
+        return {
+            change: {
+                path: relativePath,
+                action: "skip",
+                target: "package-json",
+                reason: "package.json not found"
+            },
+            warnings: ["Skipped package.json scripts because package.json was not found."]
+        };
+    }
+    let parsed;
+    try {
+        parsed = JSON.parse(existing);
+    }
+    catch {
+        return {
+            change: {
+                path: relativePath,
+                action: "skip",
+                target: "package-json",
+                reason: "package.json is not valid JSON"
+            },
+            warnings: ["package.json is not valid JSON; init did not apply partial changes."],
+            error: {
+                code: "HUMANISH_INVALID_PACKAGE_JSON",
+                message: "package.json is not valid JSON. Fix it before running humanish init."
+            }
+        };
+    }
+    if (!isRecord(parsed)) {
+        return {
+            change: {
+                path: relativePath,
+                action: "skip",
+                target: "package-json",
+                reason: "package.json root is not an object"
+            },
+            warnings: ["package.json root is not an object; init did not apply partial changes."],
+            error: {
+                code: "HUMANISH_INVALID_PACKAGE_JSON",
+                message: "package.json root must be an object. Fix it before running humanish init."
+            }
+        };
+    }
+    const scripts = isRecord(parsed.scripts) ? { ...parsed.scripts } : {};
+    const missingScripts = {};
+    const conflictingScripts = [];
+    for (const [name, command] of Object.entries(humanishScripts)) {
+        const existingScript = scripts[name];
+        if (existingScript === undefined) {
+            missingScripts[name] = command;
+        }
+        else if (existingScript !== command) {
+            conflictingScripts.push(name);
+        }
+    }
+    if (conflictingScripts.length > 0 && Object.keys(missingScripts).length === 0) {
+        return {
+            change: {
+                path: relativePath,
+                action: "skip",
+                target: "package-json",
+                reason: `existing script conflicts: ${conflictingScripts.join(", ")}`
+            },
+            warnings: [
+                `Skipped package.json script patch because these scripts already exist with different values: ${conflictingScripts.join(", ")}.`
+            ]
+        };
+    }
+    if (Object.keys(missingScripts).length === 0) {
+        return {
+            change: {
+                path: relativePath,
+                action: "skip",
+                target: "package-json",
+                reason: "Humanish scripts already present"
+            },
+            warnings: []
+        };
+    }
+    parsed.scripts = {
+        ...scripts,
+        ...missingScripts
+    };
+    const warnings = conflictingScripts.length === 0
+        ? []
+        : [
+            `Preserved existing script values for conflicting scripts: ${conflictingScripts.join(", ")}.`
+        ];
+    return {
+        write: {
+            absolutePath,
+            relativePath,
+            contents: `${JSON.stringify(parsed, null, 2)}\n`,
+            target: "package-json"
+        },
+        change: {
+            path: relativePath,
+            action: "update",
+            target: "package-json",
+            reason: `add scripts: ${Object.keys(missingScripts).join(", ")}`
+        },
+        warnings
+    };
+}
+async function readTextIfExists(projectRoot, relativePath) {
+    const bytes = await readContainedRegularFile(projectRoot, relativePath);
+    if (bytes !== null) {
+        return bytes.toString("utf8");
+    }
+    const target = path.join(projectRoot.physicalPath, relativePath);
+    try {
+        await lstat(target);
+    }
+    catch (error) {
+        if (isNodeError(error) && error.code === "ENOENT") {
+            return null;
+        }
+        throw error;
+    }
+    throw new Error(unsafeProjectPath(relativePath).message);
+}
+async function pathExists(projectRoot, relativePath) {
+    await assertPreparedSelectedOutputDirectory(projectRoot);
+    const filePath = path.join(projectRoot.physicalPath, relativePath);
+    try {
+        const stats = await lstat(filePath);
+        if (stats.isSymbolicLink() || !stats.isDirectory()) {
+            throw new Error(unsafeProjectPath(relativePath).message);
+        }
+        return true;
+    }
+    catch (error) {
+        if (isNodeError(error) && error.code === "ENOENT") {
+            return false;
+        }
+        throw error;
+    }
+}
+async function validateCwd(cwd) {
+    try {
+        const stats = await stat(cwd);
+        if (!stats.isDirectory()) {
+            return {
+                code: "HUMANISH_INVALID_CWD",
+                message: `Target cwd is not a directory: ${cwd}`
+            };
+        }
+        return null;
+    }
+    catch (error) {
+        if (isNodeError(error) && error.code === "ENOENT") {
+            return {
+                code: "HUMANISH_INVALID_CWD",
+                message: `Target cwd does not exist: ${cwd}`
+            };
+        }
+        throw error;
+    }
+}
+function trimTrailingNewlines(text) {
+    return text.replace(/\n+$/, "");
+}
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function isPathInside(root, candidate) {
+    const relative = path.relative(root, candidate);
+    return relative === ""
+        || (relative !== ".." && !relative.startsWith(`..${path.sep}`) && !path.isAbsolute(relative));
+}
+function isNodeError(error) {
+    return error instanceof Error && "code" in error;
+}
+//# sourceMappingURL=init.js.map

package/dist/init.js.map

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

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

@@ -0,0 +1,78 @@
+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;