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

package/dist/skill.js

@@ -0,0 +1,110 @@
+import { readFileSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
+import { SKILL_MARKER_BEGIN, SKILL_MARKER_END } from "./config.js";
+export const SKILL_HEADINGS = [
+    "When to scan",
+    "Git preconditions",
+    "Transport",
+    "Connect with Link",
+    "Relay human actions",
+    "Waiting",
+    "Reading the report",
+    "Fix loop",
+    "Stop conditions",
+    "Report back",
+    "Email",
+    "Never print tokens",
+];
+export function skillCorePath() {
+    return join(dirname(fileURLToPath(import.meta.url)), "..", "assets", "skill-core.md");
+}
+export function loadSkillCore(readFile = defaultRead) {
+    return readFile(skillCorePath()).replace(/\s+$/, "") + "\n";
+}
+function defaultRead(path) {
+    return readFileSync(path, "utf8");
+}
+export function renderSkillMd(core) {
+    const body = core.trim();
+    return [
+        "---",
+        "name: cleanslop",
+        "description: Run a CleanSlop readiness scan before claiming a change is done. Use at milestones, before a PR, or when asked to scan.",
+        "---",
+        "",
+        "# CleanSlop",
+        "",
+        body,
+        "",
+    ].join("\n");
+}
+export function renderCursorMdc(core) {
+    const body = core.trim();
+    return [
+        "---",
+        "description: CleanSlop readiness scan — run before claiming work is done",
+        "alwaysApply: true",
+        "---",
+        "",
+        body,
+        "",
+    ].join("\n");
+}
+export function renderAgentsSnippet(core) {
+    const body = core.trim();
+    return [
+        SKILL_MARKER_BEGIN,
+        "",
+        "## CleanSlop readiness scan",
+        "",
+        body,
+        "",
+        SKILL_MARKER_END,
+        "",
+    ].join("\n");
+}
+export function wrapOwnedFile(content) {
+    const trimmed = content.replace(/\s+$/, "");
+    if (trimmed.includes(SKILL_MARKER_BEGIN) && trimmed.includes(SKILL_MARKER_END)) {
+        return `${trimmed}\n`;
+    }
+    return `${SKILL_MARKER_BEGIN}\n${trimmed}\n${SKILL_MARKER_END}\n`;
+}
+export function upsertMarkerBlock(existing, block) {
+    const begin = existing.indexOf(SKILL_MARKER_BEGIN);
+    const end = existing.indexOf(SKILL_MARKER_END);
+    if (begin >= 0 && end > begin) {
+        const afterEnd = end + SKILL_MARKER_END.length;
+        const before = existing.slice(0, begin);
+        let after = existing.slice(afterEnd);
+        if (after.startsWith("\n"))
+            after = after.slice(1);
+        const prefix = before.endsWith("\n") || before.length === 0 ? before : `${before}\n`;
+        return `${prefix}${block}${after.startsWith("\n") || after.length === 0 ? after : `\n${after}`}`;
+    }
+    const prefix = existing.length === 0 || existing.endsWith("\n") ? existing : `${existing}\n`;
+    const spacer = prefix.length === 0 || prefix.endsWith("\n\n") ? "" : "\n";
+    return `${prefix}${spacer}${block}`;
+}
+export function removeMarkerBlock(existing) {
+    const begin = existing.indexOf(SKILL_MARKER_BEGIN);
+    const end = existing.indexOf(SKILL_MARKER_END);
+    if (begin < 0 || end < begin)
+        return existing;
+    const afterEnd = end + SKILL_MARKER_END.length;
+    const before = existing.slice(0, begin);
+    let after = existing.slice(afterEnd);
+    if (after.startsWith("\n"))
+        after = after.slice(1);
+    return `${before}${after}`.replace(/\n{3,}/g, "\n\n");
+}
+export function assertSkillCoreComplete(core) {
+    const missing = [];
+    for (const heading of SKILL_HEADINGS) {
+        if (!core.includes(`## ${heading}`))
+            missing.push(heading);
+    }
+    return missing;
+}
+//# sourceMappingURL=skill.js.map

package/dist/skill.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,144 @@
+export type CommandName = "scan" | "login" | "logout" | "whoami" | "status" | "report" | "setup" | "email" | "link-identity" | "credits";
+export type ReportFormat = "md" | "json";
+export type ParsedArgs = {
+    command: CommandName;
+    help: boolean;
+    version: boolean;
+    id: string | null;
+    json: boolean;
+    wait: boolean;
+    waitMs: number;
+    noWait: boolean;
+    resume: boolean;
+    force: boolean;
+    preview: boolean;
+    format: ReportFormat;
+    dryRun: boolean;
+    uninstall: boolean;
+    project: boolean;
+    yes: boolean;
+    consent: string | null;
+    reply: string | null;
+    link: boolean;
+    acceptTerms: boolean;
+    yesShareEmail: boolean;
+    pack: string | null;
+    amount: number | null;
+    networkId: string | null;
+    spendRequestId: string | null;
+};
+export type AgentScan = {
+    id: string;
+    status: string;
+    final: boolean;
+    source?: string;
+    project?: {
+        id: string;
+        name: string;
+    };
+    commitSha?: string | null;
+    findingCount?: number;
+    elapsedSec?: number;
+    eta?: {
+        minSec: number;
+        maxSec: number;
+    } | null;
+    progress?: {
+        phase: string;
+        label: string;
+        percent?: number;
+        step?: number;
+        steps?: number;
+    } | null;
+    error?: {
+        code: string;
+        message: string;
+    } | null;
+    pollAfterSec?: number;
+    next?: {
+        action: string;
+        afterSec: number;
+        message: string;
+    };
+    links?: {
+        report_md?: string;
+        report_json?: string;
+        web?: string;
+    };
+};
+export type AgentErrorBody = {
+    error?: string;
+    message?: string;
+    error_description?: string;
+    action?: {
+        kind?: string;
+        url?: string;
+        retryAfterSec?: number;
+        humanPrompt?: string;
+    };
+    [key: string]: unknown;
+};
+export type MeResponse = {
+    user?: {
+        githubLogin?: string | null;
+        emailMasked?: string | null;
+        emailVerified?: boolean;
+    };
+    grant?: {
+        id?: string;
+        label?: string;
+        scopes?: string;
+    };
+    quota?: {
+        plan?: string;
+        remaining?: number;
+        monthlyLeft?: number;
+        credits?: number;
+    };
+    links?: {
+        account?: string;
+        topUp?: string;
+    };
+    uploads?: boolean;
+    link?: {
+        verified?: boolean;
+        emailMasked?: string | null;
+    };
+};
+export type DeviceStartResponse = {
+    device_code: string;
+    user_code: string;
+    verification_uri: string;
+    verification_uri_complete: string;
+    expires_in: number;
+    interval: number;
+};
+export type DeviceTokenResponse = {
+    access_token: string;
+    token_type?: string;
+    scope?: string;
+    grant_id?: string;
+    account?: {
+        github_login?: string | null;
+        email_masked?: string | null;
+    };
+};
+export type StartScanResponse = {
+    scan: AgentScan;
+    created?: boolean;
+    deduped?: boolean;
+    charged?: string | null;
+};
+export type GitSnapshot = {
+    toplevel: string;
+    remote: string;
+    commitSha: string;
+    branch: string;
+    dirty: boolean;
+    unpushed: boolean;
+    github: {
+        owner: string;
+        repo: string;
+        fullName: string;
+    } | null;
+};

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/dist/ustar.d.ts

@@ -0,0 +1,7 @@
+export type UstarFile = {
+    name: string;
+    content: Buffer;
+};
+export declare function createUstar(files: readonly UstarFile[]): Buffer;
+/** gzipSync with mtime 0 and OS=255 so the bytes match on every platform. */
+export declare function gzipDeterministic(data: Buffer): Buffer;

package/dist/ustar.js

@@ -0,0 +1,128 @@
+import { gzipSync } from "node:zlib";
+const BLOCK = 512;
+const USTAR_NAME = 100;
+const USTAR_PREFIX = 155;
+function writeOctal(buf, offset, length, value) {
+    const digits = length - 1;
+    const body = value.toString(8).padStart(digits, "0");
+    if (body.length > digits) {
+        throw new Error(`octal field overflow: ${value} needs more than ${digits} digits`);
+    }
+    buf.write(body, offset, digits, "ascii");
+    buf[offset + digits] = 0;
+}
+function writeBytes(buf, offset, max, value) {
+    const bytes = Buffer.from(value, "utf8");
+    if (bytes.length > max) {
+        throw new Error(`ustar field too long (${bytes.length} > ${max})`);
+    }
+    bytes.copy(buf, offset);
+}
+function paxRecord(keyword, value) {
+    const suffix = ` ${keyword}=${value}\n`;
+    let len = Buffer.byteLength(`${suffix.length}${suffix}`, "utf8");
+    for (let i = 0; i < 8; i += 1) {
+        const rec = `${len}${suffix}`;
+        const actual = Buffer.byteLength(rec, "utf8");
+        if (actual === len)
+            return Buffer.from(rec, "utf8");
+        len = actual;
+    }
+    throw new Error("pax record length did not converge");
+}
+function padToBlock(data) {
+    const rem = data.length % BLOCK;
+    if (rem === 0)
+        return data;
+    return Buffer.concat([data, Buffer.alloc(BLOCK - rem)]);
+}
+function splitUstarName(posixPath) {
+    const pathBytes = Buffer.byteLength(posixPath, "utf8");
+    if (pathBytes <= USTAR_NAME)
+        return { name: posixPath, prefix: "" };
+    const parts = posixPath.split("/");
+    for (let i = 1; i < parts.length; i += 1) {
+        const prefix = parts.slice(0, i).join("/");
+        const name = parts.slice(i).join("/");
+        if (Buffer.byteLength(prefix, "utf8") <= USTAR_PREFIX &&
+            Buffer.byteLength(name, "utf8") <= USTAR_NAME) {
+            return { name, prefix };
+        }
+    }
+    return null;
+}
+function ustarHeader(opts) {
+    const header = Buffer.alloc(BLOCK);
+    writeBytes(header, 0, USTAR_NAME, opts.name);
+    writeOctal(header, 100, 8, opts.mode);
+    writeOctal(header, 108, 8, 0);
+    writeOctal(header, 116, 8, 0);
+    writeOctal(header, 124, 12, opts.size);
+    writeOctal(header, 136, 12, 0);
+    header.fill(0x20, 148, 156);
+    header.write(opts.typeflag, 156, 1, "ascii");
+    header.write("ustar\0", 257, 6, "ascii");
+    header.write("00", 263, 2, "ascii");
+    writeBytes(header, 345, USTAR_PREFIX, opts.prefix);
+    let sum = 0;
+    for (let i = 0; i < BLOCK; i += 1)
+        sum += header[i];
+    const chk = `${sum.toString(8).padStart(6, "0")}\0 `;
+    header.write(chk, 148, 8, "ascii");
+    return header;
+}
+function shortNameForPax(posixPath, index) {
+    const base = posixPath.split("/").pop() || "file";
+    if (Buffer.byteLength(base, "utf8") <= USTAR_NAME)
+        return base;
+    return `file-${index}`;
+}
+function fileBlocks(file, index) {
+    const chunks = [];
+    const split = splitUstarName(file.name);
+    let name;
+    let prefix;
+    if (split) {
+        name = split.name;
+        prefix = split.prefix;
+    }
+    else {
+        const pax = paxRecord("path", file.name);
+        const paxName = `PaxHeader/${index}`;
+        chunks.push(ustarHeader({
+            name: paxName,
+            prefix: "",
+            size: pax.length,
+            typeflag: "x",
+            // Regular files and PAX headers are 0644. No directory / 0755 entries.
+            mode: 0o644,
+        }), padToBlock(pax));
+        name = shortNameForPax(file.name, index);
+        prefix = "";
+    }
+    chunks.push(ustarHeader({
+        name,
+        prefix,
+        size: file.content.length,
+        typeflag: "0",
+        mode: 0o644, // files only; no 0755 / directory entries
+    }), padToBlock(file.content));
+    return chunks;
+}
+export function createUstar(files) {
+    const sorted = [...files].sort((a, b) => (a.name < b.name ? -1 : a.name > b.name ? 1 : 0));
+    const chunks = [];
+    sorted.forEach((file, index) => {
+        chunks.push(...fileBlocks(file, index));
+    });
+    chunks.push(Buffer.alloc(BLOCK), Buffer.alloc(BLOCK));
+    return Buffer.concat(chunks);
+}
+/** gzipSync with mtime 0 and OS=255 so the bytes match on every platform. */
+export function gzipDeterministic(data) {
+    const gz = gzipSync(data, { level: 6 });
+    gz.writeUInt32LE(0, 4);
+    gz[9] = 255;
+    return gz;
+}
+//# sourceMappingURL=ustar.js.map

package/dist/ustar.js.map

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

package/dist/wait.d.ts

@@ -0,0 +1,11 @@
+import type { CliDeps } from "./deps.js";
+import type { AgentScan } from "./types.js";
+export declare function isScanFinal(scan: AgentScan): boolean;
+export declare function clampPollMs(pollAfterSec: number | undefined, minPollMs: number): number;
+export declare function fetchScan(deps: CliDeps, origin: string, token: string, scanId: string, waitSec: number): Promise<AgentScan>;
+export declare function waitForScan(deps: CliDeps, origin: string, token: string, scanId: string, budgetMs: number): Promise<AgentScan>;
+export declare function backoffSleep(deps: CliDeps, attempt: number, result?: {
+    status: number;
+    headers: Headers;
+    json: unknown;
+}): Promise<void>;

package/dist/wait.js

@@ -0,0 +1,80 @@
+import { LONGPOLL_MAX_SEC } from "./config.js";
+import { CliError, EXIT_RUNNING, EXIT_UNEXPECTED } from "./exit.js";
+import { httpRequest, requireOk, retryAfterMs } from "./http.js";
+import { formatEtaLine, writeScanNext } from "./output.js";
+export function isScanFinal(scan) {
+    return scan.final === true;
+}
+export function clampPollMs(pollAfterSec, minPollMs) {
+    const fromServer = (pollAfterSec ?? 10) * 1000;
+    return Math.max(minPollMs, fromServer);
+}
+export async function fetchScan(deps, origin, token, scanId, waitSec) {
+    const q = waitSec > 0 ? `?waitSec=${waitSec}` : "";
+    const result = await httpRequest(deps, origin, "GET", `/api/agent/v1/scans/${encodeURIComponent(scanId)}${q}`, { token });
+    if (result.status === 429) {
+        throw new CliError("Rate limited while waiting for the scan.", EXIT_RUNNING);
+    }
+    requireOk(result);
+    const rec = result.json;
+    if (!rec || typeof rec !== "object" || typeof rec.id !== "string") {
+        throw new CliError("Scan status response was not valid JSON.", EXIT_UNEXPECTED);
+    }
+    return rec;
+}
+export async function waitForScan(deps, origin, token, scanId, budgetMs) {
+    const deadline = deps.clock.now() + budgetMs;
+    let last = null;
+    let first = true;
+    while (first || deps.clock.now() < deadline) {
+        first = false;
+        const remainingMs = Math.max(0, deadline - deps.clock.now());
+        const waitSec = Math.min(LONGPOLL_MAX_SEC, Math.max(0, Math.floor(remainingMs / 1000)));
+        try {
+            last = await fetchScan(deps, origin, token, scanId, waitSec);
+        }
+        catch (err) {
+            if (err instanceof CliError && err.exitCode === EXIT_RUNNING) {
+                const remaining = deadline - deps.clock.now();
+                if (remaining <= 0)
+                    break;
+                await deps.clock.sleep(Math.min(deps.minPollMs, remaining));
+                continue;
+            }
+            throw err;
+        }
+        if (isScanFinal(last)) {
+            return last;
+        }
+        if (last.progress) {
+            deps.io.stderr(`${last.progress.label}\n`);
+        }
+        const eta = formatEtaLine(last);
+        if (eta) {
+            deps.io.stderr(`${eta}\n`);
+        }
+        writeScanNext(deps, last);
+        const remaining = deadline - deps.clock.now();
+        if (remaining <= 0)
+            break;
+        const gap = clampPollMs(last.pollAfterSec, deps.minPollMs);
+        await deps.clock.sleep(Math.min(gap, remaining));
+    }
+    if (last)
+        return last;
+    throw new CliError("Timed out waiting for the scan.", EXIT_RUNNING);
+}
+export async function backoffSleep(deps, attempt, result) {
+    const base = Math.min(30_000, 2000 * 2 ** Math.min(attempt, 4));
+    if (result && result.status === 429) {
+        await deps.clock.sleep(retryAfterMs({
+            status: result.status,
+            headers: result.headers,
+            text: "",
+            json: result.json,
+        }, base));
+        return;
+    }
+    await deps.clock.sleep(base);
+}
+//# sourceMappingURL=wait.js.map

package/dist/wait.js.map

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

package/package.json

@@ -1,6 +1,32 @@
 {
   "name": "@cleanslop/cli",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.0-beta.0",
+  "description": "CleanSlop CLI — readiness scans from your coding agent",
+  "type": "module",
+  "bin": {
+    "cleanslop": "dist/index.js"
+  },
+  "files": [
+    "dist",
+    "assets",
+    "README.md"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "test": "c8 --config c8.config.json node --import tsx --test --test-reporter spec 'test/**/*.test.ts'",
+    "typecheck": "tsc --noEmit -p tsconfig.json"
+  },
+  "license": "UNLICENSED",
+  "devDependencies": {
+    "@types/node": "^20.19.25",
+    "c8": "^12.0.0",
+    "tsx": "^4.20.6",
+    "typescript": "^5.9.3"
+  }
+}