humanish 0.0.1 → 0.15.0

package/dist/init.js

@@ -0,0 +1,343 @@
+import { mkdir, readFile, stat, writeFile } from "node:fs/promises";
+import path from "node:path";
+import { humanishScripts, runtimeDirectories, starterFiles } from "./init-templates.js";
+export const INIT_RESPONSE_SCHEMA = "humanish.init-result.v1";
+export async function runInit(options) {
+    const cwd = path.resolve(options.cwd);
+    const mode = getMode(options);
+    const warnings = [];
+    const changes = [];
+    const writes = [];
+    const dirs = [];
+    const cwdCheck = await validateCwd(cwd);
+    if (cwdCheck) {
+        return {
+            schema: INIT_RESPONSE_SCHEMA,
+            ok: false,
+            mode,
+            cwd,
+            changes,
+            warnings,
+            error: cwdCheck
+        };
+    }
+    for (const file of starterFiles) {
+        const absolutePath = path.join(cwd, file.path);
+        const existing = await readTextIfExists(absolutePath);
+        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(absolutePath);
+        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(cwd);
+    changes.push(gitignorePlan.change);
+    if (gitignorePlan.write) {
+        writes.push(gitignorePlan.write);
+    }
+    const packagePlan = await planPackageJson(cwd);
+    changes.push(packagePlan.change);
+    warnings.push(...packagePlan.warnings);
+    if (packagePlan.error) {
+        return {
+            schema: INIT_RESPONSE_SCHEMA,
+            ok: false,
+            mode,
+            cwd,
+            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,
+            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") {
+        for (const directory of dirs) {
+            await mkdir(directory.absolutePath, { recursive: true });
+        }
+        for (const write of writes) {
+            await mkdir(path.dirname(write.absolutePath), { recursive: true });
+            await writeFile(write.absolutePath, write.contents, "utf8");
+        }
+    }
+    return {
+        schema: INIT_RESPONSE_SCHEMA,
+        ok: true,
+        mode,
+        cwd,
+        changes,
+        warnings
+    };
+}
+function getMode(options) {
+    if (options.dryRun) {
+        return "dry-run";
+    }
+    if (options.yes) {
+        return "applied";
+    }
+    return "needs-confirmation";
+}
+async function planGitignore(cwd) {
+    const relativePath = ".gitignore";
+    const absolutePath = path.join(cwd, relativePath);
+    const existing = await readTextIfExists(absolutePath);
+    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(cwd) {
+    const relativePath = "package.json";
+    const absolutePath = path.join(cwd, relativePath);
+    const existing = await readTextIfExists(absolutePath);
+    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(filePath) {
+    try {
+        return await readFile(filePath, "utf8");
+    }
+    catch (error) {
+        if (isNodeError(error) && error.code === "ENOENT") {
+            return null;
+        }
+        throw error;
+    }
+}
+async function pathExists(filePath) {
+    try {
+        await stat(filePath);
+        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 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;