@cleanslop/cli 0.0.0-stage → 0.1.0-beta.1.2

package/dist/deps.d.ts

@@ -0,0 +1,58 @@
+export type GitResult = {
+    ok: boolean;
+    stdout: string;
+    stderr: string;
+    code: number;
+};
+export type HttpResult = {
+    status: number;
+    headers: Headers;
+    text: string;
+    json: unknown | null;
+};
+export type CliIo = {
+    stdout: (text: string) => void;
+    stderr: (text: string) => void;
+    stdinIsTTY: boolean;
+};
+export type ExecFileOpts = {
+    cwd?: string;
+    env?: NodeJS.ProcessEnv;
+    timeout?: number;
+};
+export type CliClock = {
+    now: () => number;
+    sleep: (ms: number) => Promise<void>;
+};
+export type CliEnv = {
+    get: (name: string) => string | undefined;
+    cwd: () => string;
+    homeDir: () => string;
+    hostname: () => string;
+    platform: NodeJS.Platform;
+};
+export type CliFs = {
+    exists: (path: string) => boolean;
+    read: (path: string) => string;
+    write: (path: string, data: string, mode: number) => void;
+    mkdir: (path: string, mode: number) => void;
+    rm: (path: string) => void;
+    chmod: (path: string, mode: number) => void;
+    statMode: (path: string) => number;
+};
+export type CliDeps = {
+    io: CliIo;
+    env: CliEnv;
+    fs: CliFs;
+    clock: CliClock;
+    git: (args: string[], cwd: string) => Promise<GitResult>;
+    execFile: (file: string, args: string[], opts?: ExecFileOpts) => Promise<GitResult>;
+    confirm: (question: string) => Promise<boolean>;
+    request: (url: string, init: RequestInit) => Promise<Response>;
+    randomId: () => string;
+    minPollMs: number;
+    defaultWaitMs: number;
+    defaultOrigin: string;
+};
+export declare function createDefaultDeps(): CliDeps;
+export declare function mergeDeps(overrides?: Partial<CliDeps>): CliDeps;

package/dist/deps.js

@@ -0,0 +1,148 @@
+import { execFile, spawn } from "node:child_process";
+import { chmodSync, existsSync, mkdirSync, readFileSync, renameSync, rmSync, statSync, writeFileSync, } from "node:fs";
+import { homedir, hostname, platform } from "node:os";
+import { DEFAULT_WAIT_MS, MIN_POLL_MS, defaultOrigin } from "./config.js";
+import { redactSecrets } from "./redact.js";
+function runExecFile(file, args, opts = {}) {
+    return new Promise((resolve) => {
+        execFile(file, args, {
+            cwd: opts.cwd,
+            env: opts.env,
+            timeout: opts.timeout,
+            encoding: "utf8",
+            maxBuffer: 16 * 1024 * 1024,
+        }, (err, stdout, stderr) => {
+            const out = typeof stdout === "string" ? stdout : "";
+            const errText = typeof stderr === "string" ? stderr : "";
+            if (err && "code" in err && err.code === "ENOENT") {
+                resolve({
+                    ok: false,
+                    stdout: out,
+                    stderr: errText || err.message,
+                    code: 127,
+                });
+                return;
+            }
+            const code = err && "code" in err && typeof err.code === "number" ? err.code : err ? 1 : 0;
+            resolve({
+                ok: code === 0,
+                stdout: out,
+                stderr: errText,
+                code,
+            });
+        });
+    });
+}
+async function defaultConfirm(question) {
+    if (!process.stdin.isTTY)
+        return false;
+    process.stderr.write(redactSecrets(`${question} [y/N] `));
+    const line = await new Promise((resolve) => {
+        const onData = (buf) => {
+            process.stdin.off("data", onData);
+            resolve(buf.toString("utf8"));
+        };
+        process.stdin.once("data", onData);
+    });
+    return /^\s*y(es)?\s*$/i.test(line);
+}
+function spawnGit(args, cwd) {
+    return new Promise((resolve) => {
+        const child = spawn("git", args, {
+            cwd,
+            stdio: ["ignore", "pipe", "pipe"],
+        });
+        const stdout = [];
+        const stderr = [];
+        child.stdout.on("data", (chunk) => {
+            stdout.push(chunk);
+        });
+        child.stderr.on("data", (chunk) => {
+            stderr.push(chunk);
+        });
+        child.on("error", (err) => {
+            resolve({
+                ok: false,
+                stdout: "",
+                stderr: err instanceof Error ? err.message : String(err),
+                code: 1,
+            });
+        });
+        child.on("close", (code) => {
+            const status = code ?? 1;
+            resolve({
+                ok: status === 0,
+                stdout: Buffer.concat(stdout).toString("utf8"),
+                stderr: Buffer.concat(stderr).toString("utf8"),
+                code: status,
+            });
+        });
+    });
+}
+export function createDefaultDeps() {
+    return {
+        io: {
+            stdout: (text) => {
+                process.stdout.write(redactSecrets(text));
+            },
+            stderr: (text) => {
+                process.stderr.write(redactSecrets(text));
+            },
+            stdinIsTTY: Boolean(process.stdin.isTTY),
+        },
+        env: {
+            get: (name) => process.env[name],
+            cwd: () => process.cwd(),
+            homeDir: () => homedir(),
+            hostname: () => hostname(),
+            platform: platform(),
+        },
+        fs: {
+            exists: (path) => existsSync(path),
+            read: (path) => readFileSync(path, "utf8"),
+            write: (path, data, mode) => {
+                const tmp = `${path}.tmp-${process.pid}`;
+                writeFileSync(tmp, data, { mode });
+                renameSync(tmp, path);
+                chmodSync(path, mode);
+            },
+            mkdir: (path, mode) => {
+                mkdirSync(path, { recursive: true, mode });
+                chmodSync(path, mode);
+            },
+            rm: (path) => {
+                rmSync(path, { force: true });
+            },
+            chmod: (path, mode) => {
+                chmodSync(path, mode);
+            },
+            statMode: (path) => statSync(path).mode & 0o777,
+        },
+        clock: {
+            now: () => Date.now(),
+            sleep: (ms) => new Promise((resolve) => {
+                setTimeout(resolve, ms);
+            }),
+        },
+        git: spawnGit,
+        execFile: runExecFile,
+        confirm: defaultConfirm,
+        request: (url, init) => fetch(url, init),
+        randomId: () => crypto.randomUUID(),
+        minPollMs: MIN_POLL_MS,
+        defaultWaitMs: DEFAULT_WAIT_MS,
+        defaultOrigin: defaultOrigin(),
+    };
+}
+export function mergeDeps(overrides = {}) {
+    const base = createDefaultDeps();
+    return {
+        ...base,
+        ...overrides,
+        io: { ...base.io, ...overrides.io },
+        env: { ...base.env, ...overrides.env },
+        fs: { ...base.fs, ...overrides.fs },
+        clock: { ...base.clock, ...overrides.clock },
+    };
+}
+//# sourceMappingURL=deps.js.map

package/dist/deps.js.map

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

package/dist/exit.d.ts

@@ -0,0 +1,24 @@
+export declare const EXIT_OK = 0;
+export declare const EXIT_UNEXPECTED = 1;
+export declare const EXIT_USAGE = 2;
+export declare const EXIT_ACTION = 10;
+export declare const EXIT_PAYMENT = 11;
+export declare const EXIT_POLICY = 12;
+export declare const EXIT_SOURCE = 13;
+export declare const EXIT_SCAN_FAILED = 20;
+export declare const EXIT_RUNNING = 75;
+export type ActionKind = "approve" | "install" | "top-up" | "beta" | "reauth" | "present_identity" | "link_existing" | "ask_human" | "ask_email" | "wait";
+export type ActionRequired = {
+    kind: ActionKind;
+    humanPrompt: string;
+    url?: string;
+    code?: string;
+};
+export declare class CliError extends Error {
+    readonly exitCode: number;
+    readonly action: ActionRequired | undefined;
+    constructor(message: string, exitCode: number, action?: ActionRequired);
+}
+export declare function usageError(message: string): CliError;
+export declare function sourceError(message: string, action?: ActionRequired): CliError;
+export declare function actionError(message: string, action: ActionRequired): CliError;

package/dist/exit.js

@@ -0,0 +1,29 @@
+export const EXIT_OK = 0;
+export const EXIT_UNEXPECTED = 1;
+export const EXIT_USAGE = 2;
+export const EXIT_ACTION = 10;
+export const EXIT_PAYMENT = 11;
+export const EXIT_POLICY = 12;
+export const EXIT_SOURCE = 13;
+export const EXIT_SCAN_FAILED = 20;
+export const EXIT_RUNNING = 75;
+export class CliError extends Error {
+    exitCode;
+    action;
+    constructor(message, exitCode, action) {
+        super(message);
+        this.name = "CliError";
+        this.exitCode = exitCode;
+        this.action = action;
+    }
+}
+export function usageError(message) {
+    return new CliError(message, EXIT_USAGE);
+}
+export function sourceError(message, action) {
+    return new CliError(message, EXIT_SOURCE, action);
+}
+export function actionError(message, action) {
+    return new CliError(message, EXIT_ACTION, action);
+}
+//# sourceMappingURL=exit.js.map

package/dist/exit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"exit.js","sourceRoot":"","sources":["../src/exit.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,OAAO,GAAG,CAAC,CAAC;AACzB,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,CAAC;AACjC,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,CAAC;AAC5B,MAAM,CAAC,MAAM,WAAW,GAAG,EAAE,CAAC;AAC9B,MAAM,CAAC,MAAM,YAAY,GAAG,EAAE,CAAC;AAC/B,MAAM,CAAC,MAAM,WAAW,GAAG,EAAE,CAAC;AAC9B,MAAM,CAAC,MAAM,WAAW,GAAG,EAAE,CAAC;AAC9B,MAAM,CAAC,MAAM,gBAAgB,GAAG,EAAE,CAAC;AACnC,MAAM,CAAC,MAAM,YAAY,GAAG,EAAE,CAAC;AAqB/B,MAAM,OAAO,QAAS,SAAQ,KAAK;IACxB,QAAQ,CAAS;IACjB,MAAM,CAA6B;IAE5C,YACE,OAAe,EACf,QAAgB,EAChB,MAAuB;QAEvB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,UAAU,CAAC;QACvB,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;CACF;AAED,MAAM,UAAU,UAAU,CAAC,OAAe;IACxC,OAAO,IAAI,QAAQ,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC;AAC3C,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,OAAe,EAAE,MAAuB;IAClE,OAAO,IAAI,QAAQ,CAAC,OAAO,EAAE,WAAW,EAAE,MAAM,CAAC,CAAC;AACpD,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,OAAe,EAAE,MAAsB;IACjE,OAAO,IAAI,QAAQ,CAAC,OAAO,EAAE,WAAW,EAAE,MAAM,CAAC,CAAC;AACpD,CAAC"}

package/dist/git.d.ts

@@ -0,0 +1,14 @@
+import type { CliDeps } from "./deps.js";
+import type { GitSnapshot } from "./types.js";
+export type GithubRemote = {
+    owner: string;
+    repo: string;
+    fullName: string;
+};
+/** Accept https, git@, and ssh:// forms on github.com only. */
+export declare function parseGithubRemote(raw: string): GithubRemote | null;
+export declare function isPathInsideWorktree(targetPath: string, worktreeRoot: string): boolean;
+export declare function gitToplevel(deps: CliDeps, cwd: string): Promise<string | null>;
+export declare function inspectGit(deps: CliDeps): Promise<GitSnapshot>;
+export declare function assertGithubReady(git: GitSnapshot): void;
+export declare function detectAgentHint(env: CliDeps["env"]): string;

package/dist/git.js

@@ -0,0 +1,161 @@
+import { existsSync, realpathSync } from "node:fs";
+import { basename, isAbsolute, relative, resolve, sep } from "node:path";
+import { sourceError } from "./exit.js";
+const OWNER_REPO_RE = /^[A-Za-z0-9._-]+\/[A-Za-z0-9._-]+$/;
+function stripGitSuffix(name) {
+    return name.replace(/\.git$/i, "");
+}
+function ownerRepoFromPath(pathname) {
+    const parts = pathname.replace(/^\/+/, "").split("/").filter(Boolean);
+    if (parts.length < 2)
+        return null;
+    const owner = parts[0];
+    const repo = stripGitSuffix(parts[1]);
+    if (!owner || !repo)
+        return null;
+    const fullName = `${owner}/${repo}`;
+    if (!OWNER_REPO_RE.test(fullName))
+        return null;
+    return { owner, repo, fullName };
+}
+function hostIsGithub(hostname) {
+    return hostname.toLowerCase() === "github.com";
+}
+/** Accept https, git@, and ssh:// forms on github.com only. */
+export function parseGithubRemote(raw) {
+    const trimmed = raw.trim();
+    if (!trimmed)
+        return null;
+    const scp = /^git@([^:]+):(.+)$/i.exec(trimmed);
+    if (scp) {
+        if (!hostIsGithub(scp[1]))
+            return null;
+        return ownerRepoFromPath(scp[2]);
+    }
+    try {
+        const withScheme = /^[a-zA-Z][a-zA-Z+.-]*:/.test(trimmed)
+            ? trimmed
+            : `https://${trimmed}`;
+        const url = new URL(withScheme);
+        const protocol = url.protocol.toLowerCase();
+        if (protocol !== "https:" && protocol !== "http:" && protocol !== "ssh:") {
+            return null;
+        }
+        if (!hostIsGithub(url.hostname))
+            return null;
+        return ownerRepoFromPath(url.pathname);
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Realpath the nearest existing ancestor and re-append the missing tail.
+ * Needed because credentials files usually do not exist yet, and git's
+ * `--show-toplevel` is already realpath'd (macOS `/var` → `/private/var`).
+ */
+function resolveThroughExistingAncestor(targetPath) {
+    const absolute = resolve(targetPath);
+    const missing = [];
+    let cursor = absolute;
+    while (!existsSync(cursor)) {
+        const parent = resolve(cursor, "..");
+        if (parent === cursor) {
+            throw new Error(`no existing ancestor for ${targetPath}`);
+        }
+        missing.unshift(basename(cursor));
+        cursor = parent;
+    }
+    const real = realpathSync(cursor);
+    return missing.length === 0 ? real : resolve(real, ...missing);
+}
+export function isPathInsideWorktree(targetPath, worktreeRoot) {
+    try {
+        const root = resolveThroughExistingAncestor(worktreeRoot);
+        const target = resolveThroughExistingAncestor(targetPath);
+        const rel = relative(root, target);
+        return (rel === "" ||
+            (rel !== ".." && !rel.startsWith(`..${sep}`) && !isAbsolute(rel)));
+    }
+    catch {
+        // Cannot resolve — refuse the write (fail closed).
+        return true;
+    }
+}
+export async function gitToplevel(deps, cwd) {
+    const result = await deps.git(["rev-parse", "--show-toplevel"], cwd);
+    if (!result.ok)
+        return null;
+    const top = result.stdout.trim();
+    return top || null;
+}
+async function requireGit(deps, args, cwd, message) {
+    const result = await deps.git(args, cwd);
+    if (!result.ok) {
+        throw sourceError(message);
+    }
+    return result.stdout.trim();
+}
+export async function inspectGit(deps) {
+    const cwd = deps.env.cwd();
+    const inside = await deps.git(["rev-parse", "--is-inside-work-tree"], cwd);
+    if (!inside.ok || inside.stdout.trim() !== "true") {
+        throw sourceError("Not a git work tree. Run this from a GitHub checkout.");
+    }
+    const toplevel = await requireGit(deps, ["rev-parse", "--show-toplevel"], cwd, "Not a git work tree. Run this from a GitHub checkout.");
+    const remote = await requireGit(deps, ["remote", "get-url", "origin"], cwd, "No origin remote. CleanSlop needs a github.com origin.");
+    const commitSha = await requireGit(deps, ["rev-parse", "HEAD"], cwd, "Could not read HEAD.");
+    const branchResult = await deps.git(["rev-parse", "--abbrev-ref", "HEAD"], cwd);
+    const branch = branchResult.ok ? branchResult.stdout.trim() : "HEAD";
+    const status = await deps.git(["status", "--porcelain"], cwd);
+    const dirty = status.ok && status.stdout.trim().length > 0;
+    const contains = await deps.git(["branch", "-r", "--contains", "HEAD"], cwd);
+    const remotes = contains.ok
+        ? contains.stdout
+            .split("\n")
+            .map((line) => line.trim())
+            .filter(Boolean)
+        : [];
+    const unpushed = !remotes.some((line) => line.startsWith("origin/"));
+    return {
+        toplevel,
+        remote,
+        commitSha,
+        branch,
+        dirty,
+        unpushed,
+        github: parseGithubRemote(remote),
+    };
+}
+export function assertGithubReady(git) {
+    if (!git.github) {
+        throw sourceError("origin is not a github.com remote. Phase 1 only scans GitHub App repos.", {
+            kind: "ask_human",
+            humanPrompt: "Point origin at a github.com repository, or wait for upload support.",
+        });
+    }
+    if (git.dirty || git.unpushed) {
+        const why = [
+            git.dirty ? "the working tree is dirty" : null,
+            git.unpushed ? "HEAD is not on any origin/* ref" : null,
+        ]
+            .filter(Boolean)
+            .join(" and ");
+        throw sourceError(`Ask the human before committing or pushing (${why}).`, {
+            kind: "ask_human",
+            humanPrompt: "This checkout has local changes or an unpushed HEAD. Ask the human to commit and push, then rerun. Do not commit or push yourself.",
+        });
+    }
+}
+export function detectAgentHint(env) {
+    if (env.get("CLAUDECODE") || env.get("CLAUDE_CODE"))
+        return "claude-code";
+    if (env.get("CURSOR_TRACE_ID") || env.get("CURSOR_AGENT"))
+        return "cursor";
+    if (env.get("CODEX_HOME") || env.get("CODEX"))
+        return "codex";
+    if (env.get("REPL_ID") || env.get("REPLIT_DEV_DOMAIN"))
+        return "replit";
+    return "other";
+}
+//# sourceMappingURL=git.js.map

package/dist/git.js.map

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

package/dist/http.d.ts

@@ -0,0 +1,16 @@
+import type { CliDeps, HttpResult } from "./deps.js";
+import type { AgentErrorBody } from "./types.js";
+export declare function hasIdentityPresentationChallenge(result: HttpResult): boolean;
+export declare function asRecord(value: unknown): Record<string, unknown> | null;
+export declare function asErrorBody(value: unknown): AgentErrorBody;
+export declare function httpRequest(deps: CliDeps, origin: string, method: string, path: string, opts?: {
+    token?: string;
+    body?: unknown;
+    rawBody?: Uint8Array;
+    headers?: Record<string, string>;
+    accept?: string;
+    contentType?: string;
+}): Promise<HttpResult>;
+export declare function throwHttpError(result: HttpResult): never;
+export declare function requireOk(result: HttpResult): HttpResult;
+export declare function retryAfterMs(result: HttpResult, fallback: number): number;