@cleanslop/cli 0.1.0-beta.2 → 0.1.0-beta.20

package/README.md

@@ -1,6 +1,6 @@
 # cleanslop CLI (M4)
 
-Private-beta CLI for agentic CleanSlop, published as `@cleanslop/cli` (bin `cleanslop`). Beta builds go out under the `beta` dist-tag from `.github/workflows/cli-beta.yml`; do not `npm publish` by hand except the one-time first publish in `docs/ops/agent-beta.md` (CLI beta).
+Private-beta CLI for agentic CleanSlop, published as `@cleanslop/cli` (bin `cleanslop`). Beta builds go out under the `beta` dist-tag from `.github/workflows/cli-beta.yml`, and releases under `latest` from `.github/workflows/cli-release.yml` on every `master` change to `cli/` (versions from `scripts/release-version.mjs`); do not `npm publish` by hand except the one-time first publish in `docs/ops/agent-beta.md` (CLI beta).
 
 ## Install / run
 
@@ -12,7 +12,7 @@ CLEANSLOP_ORIGIN=<origin> npx @cleanslop/cli@beta scan
 node cli/dist/index.js scan
 ```
 
-Requires Node 20 or later. **Zero runtime dependencies.** Link commands shell out to `link-cli` (`CLEANSLOP_LINK_CLI`, else `PATH`, else a pinned `npx @stripe/link-cli`); uploads pack with system `tar`.
+Requires Node 20 or later. **Zero runtime dependencies.** Link commands shell out to `link-cli` (`CLEANSLOP_LINK_CLI`, else `PATH`, else a pinned `npx @stripe/link-cli`); uploads pack with a built-in tar writer.
 
 ## Gate (run locally and in CI)
 
@@ -30,11 +30,12 @@ The app TypeScript / ESLint / coverage gates exclude `cli/` (`tsconfig.json`, `t
 |---|---|
 | `scan` (default) | Resolve the github.com origin + HEAD, start a scan, optionally `--wait` |
 | `login [--no-wait \| --resume]` | RFC 8628 device flow. Prints `verification_uri_complete` and `user_code`. `--no-wait` stores the device code; `--resume` finishes it. Never prints the token. |
-| `logout` | Revoke server-side and delete local credentials |
+| `logout [--all]` | Revoke server-side, delete this origin's credentials, and drop its pending GitHub login and Link payment. `--all` revokes every saved origin's token and deletes all local CleanSlop data (Link's own session and `~/.link-cli` files stay; `link-cli auth logout` clears the session) |
 | `whoami` | Connected `@login` and token last4 |
 | `status [id] [--wait]` | Poll scan status |
 | `report [id] [--format md\|json] [--preview]` | Fetch `cleanslop.report.v1` |
 | `setup` | Idempotent skill/rules. Never logs in, never writes a token |
+| `redeem <code>` | Redeem a promo (invite) code the human gave you for free scans (`POST /api/agent/v1/credits/redeem`). One code per account; `promo_invalid` / `promo_already_redeemed` exit 12 with an `ask_human` block. |
 
 ### Wait
 
@@ -80,7 +81,7 @@ Skill / Cursor rules / AGENTS snippet are generated from [`assets/skill-core.md`
 | 20 | Scan failed server-side |
 | 75 | Still running; resume command printed |
 
-`CLEANSLOP_ACTION_REQUIRED` blocks go to stderr. Never open, approve, or pay.
+`CLEANSLOP_ACTION_REQUIRED` blocks go to stderr. Never open, approve, or pay. A block may end with a `CLEANSLOP_QUESTION:` JSON line (`id`, `header`, `question`, `options[]` with `value`, `label`, optional `description`, and `run` for the exact next command or `next` for a plain next step; neither means stop). Agents with a multiple-choice question tool (for example Claude Code's AskUserQuestion) should ask with it, using exactly those options, and never answer for the human. Consent questions never carry `--agree`.
 
 ## Tests
 

package/assets/skill-core.md

@@ -4,26 +4,44 @@ Run a CleanSlop readiness scan at milestones (before claiming work is done, befo
 
 ## Git preconditions
 
-Work from a git checkout whose `origin` is on github.com, unless `/me` reports `uploads: true` (Link). For GitHub scans, if the tree is dirty or HEAD is not on GitHub, **ask the human before committing or pushing**. Do not commit, push, stash, or rewrite history yourself. For Link uploads, pack the working tree and skip the push step.
+Just run `cleanslop scan`. Do not check git state first or tell the human a commit or push may be needed: the CLI picks the source and asks when the human must choose. A clean pushed github.com commit is scanned from GitHub. Otherwise, when `/me` reports `uploads: true` (Link) or `uploadFallback: true` (GitHub), it uploads the local files: a folder with no commits or no GitHub origin uploads at once, and uncommitted or unpushed changes ask `push_or_upload` ("Scan local files" reruns with `--upload`; "I pushed" reruns as is). A `github_install` question also offers "Scan local files". Do not commit, push, stash, or rewrite history yourself.
 
 ## Transport
 
 Use MCP if it is registered (`<origin>/mcp`); otherwise the CLI. Run it as `npx @cleanslop/cli <command>` unless `cleanslop` is already installed (commands below are written as `cleanslop …`). If your harness blocks npx, **ask the human** to allow it or run the command themselves; do not work around the block. In Claude Code, run long waits as a **background** command (`cleanslop scan --wait 75m`) so waiting costs zero tokens. `cleanslop setup` registers MCP for Claude Code, Cursor, and Codex and never writes a token. MCP stays on GitHub; connect with Link through the CLI.
 
-## Connect with Link
+## Connect
 
-Run Link and login commands in the foreground with `--no-wait`. When one prints an `approve` block, relay the link and code, wait for the human to approve, then rerun the same command with `--resume` instead of `--no-wait`.
+If the human already said how to connect (Link or GitHub), use that. Otherwise, when a command says this machine is not connected and asks how to connect (`connect_method`), ask the human with exactly its options (Stripe Link, recommended, or GitHub).
+
+Run Link and login commands in the foreground with `--no-wait`. When one prints an `approve` block, ask its Done / Not now question (it repeats the link and code). On Done, rerun the same command with `--resume` instead of `--no-wait`; on Not now, stop. Never ask the human to type “done”.
+
+**GitHub:** run `cleanslop login --no-wait`, then the approve-then-`--resume` step.
+
+**Link:**
 
 1. Run `cleanslop login --link --no-wait`. The first run stops with an `ask_human` block quoting one question (an account from the Link-verified email, plus the terms). Relay it **exactly as printed**.
 2. If the human says yes, rerun with `--agree --no-wait`. If not, stop.
-3. If Link is not signed in on this machine, the CLI prints an `approve` block with a Link link and a phrase and exits 10. Relay them; after the human approves in the Link app, rerun with `--resume` instead of `--no-wait`.
+3. If Link is not signed in on this machine, the CLI prints an `approve` block with a Link link and a phrase and exits 10. Ask its Done question; on Done, rerun with `--resume` instead of `--no-wait`.
 4. On success it prints “Connected as <masked email> (Link)”. Repeat that to the human.
 5. `link_existing` means the Link email already belongs to a CleanSlop account. Run `cleanslop login --no-wait` (GitHub device login), then `cleanslop link-identity --no-wait`, each with the approve-then-`--resume` step above. `link-identity` asks its own email question (`--agree` after a yes).
 6. `beta` means this Link email is not in the pilot yet. Tell the human and stop.
+7. If Link sign-in fails and the CLI offers GitHub instead (`link_failed`), ask the human; Link may not be available to them.
+
+## Buy credits with Link
+
+Run purchase commands in the foreground with `--no-wait`, the same way as Link sign-in. The human approves every payment in their Link app; never approve or pay yourself.
+
+1. When a scan exits 11 with a `top-up` block, or `credits buy` without `--pack` asks which pack, ask the human to choose (the block lists each pack's scans, price, and price per scan). If they choose not to buy, stop. Never pick a pack for them.
+2. Run `cleanslop credits buy --link --pack <pack> --no-wait` with their pack. It prints an `approve` block and exits 10. Ask its Done question: Link sends the approval to the human's Link app, and there is usually no link to open. If Link first needs payment permission, the block says so (header Permission): relay it as a one-time permission, not the purchase; nothing is charged, and the purchase approval comes next.
+3. When the human answers Done, run `cleanslop credits buy --link --resume`. If it prints `approve` again, they have not approved yet: relay the prompt again and wait. If it prints `ask_human`, relay it and follow it. Never start a second purchase while one is pending.
+4. On success it prints “Added … scan credits. Balance: N”. Rerun the scan.
+5. If the CLI says Link packs are not available or to contact us for credits, tell the human and stop. For a GitHub account, the `top-up` block is a checkout link instead: relay it and wait.
+6. Promo codes: if the human gives you a CleanSlop promo code, run `cleanslop redeem <code>` (MCP: `promo_redeem`). Use only a code the human typed in this session; never guess, search for, or reuse one. Each account can use one code; if the CLI says the code is not valid or already used, tell the human and stop. While the account has not used a code, the out-of-scans and `credits buy` questions also offer "Use a promo code"; if the human picks buying instead, run the command that answer gives.
 
 ## Relay human actions
 
-When the CLI prints a `CLEANSLOP_ACTION_REQUIRED` block, show the human the link and code **exactly as printed** and wait. Kinds: approve (device login or Link sign-in), install (GitHub App), top-up (credits), beta (request access), reauth (reconnect GitHub), present_identity (Link), link_existing (connect Link to an existing account), ask_human (quoted terms or email-sharing question). Never open the link, never approve, never pay, never enter credentials. `cleanslop login --link` drives `link-cli` itself (Link sign-in, attestations, identity credential). Never run `link-cli … present`, `attestations pop`, or `spend-request` yourself, and never paste their output. When CleanSlop says the person must approve a payment in Link, tell them and wait. Pass `--agree` only after the human answers yes to the quoted question in this session. After login, repeat “Connected as @login” or the masked Link email to the human.
+When the CLI prints a `CLEANSLOP_ACTION_REQUIRED` block, show the human the link and code **exactly as printed** and wait. Blocks that wait on the human (approvals, GitHub App install, push, checkout) carry a Done / Not now question; ask it rather than asking them to reply. Kinds: approve (device login, Link sign-in, or a Link payment), install (GitHub App), top-up (credits), beta (request access), reauth (reconnect GitHub), present_identity (Link), link_existing (connect Link to an existing account), ask_human (quoted terms or email-sharing question). Never open the link, never approve, never pay, never enter credentials. `cleanslop login --link` drives `link-cli` itself (Link sign-in, attestations, identity credential). Never run `link-cli … present`, `attestations pop`, or `spend-request` yourself, and never paste their output. When CleanSlop says the person must approve a payment in Link, tell them and wait. Pass `--agree` only after the human answers yes to the quoted question in this session. When a block includes a `CLEANSLOP_QUESTION:` line (a JSON question with options), you must ask it with your multiple-choice question tool if you have one (for example AskUserQuestion), offering exactly those options; never ask the human to type a reply such as “Done” instead. Only without such a tool, ask in plain text. Never answer for the human. Then do what the chosen option says: run its `run` command, follow its `next` step, or stop if it has neither. MCP tool results carry the same JSON as `action.question` on an error, or `question` on a preview; their options use `next` only. After login, repeat “Connected as @login” or the masked Link email to the human.
 
 ## Waiting
 
@@ -43,11 +61,11 @@ When `review` is `unavailable`, the findings are unreviewed first-pass results (
 
 ## Fix loop
 
-Fix by priority, run the repo’s tests, ask the human about `needs_input`, get a commit and push from the human, rescan **once**, and compare the delta (`new` / `still_open` / `resolved` / `no_longer_listed`). `no_longer_listed` means the review stopped listing the finding — it is not a confirmed fix.
+Fix by priority, run the repo’s tests, ask the human about `needs_input`, rescan **once** (the CLI asks whether to upload the local files or have the human push first), and compare the delta (`new` / `still_open` / `resolved` / `no_longer_listed`). `no_longer_listed` means the review stopped listing the finding — it is not a confirmed fix.
 
 ## Stop conditions
 
-Stop when all listed issues are resolved; the same fingerprints are still open after one rescan; the CLI reports `out_of_scans`; the human declines; or the commit has not changed.
+Stop when all listed issues are resolved; the same fingerprints are still open after one rescan; the account is out of scans and the human does not buy more (or none can be bought); the human declines; or the code has not changed.
 
 ## Report back
 

package/dist/action.d.ts

@@ -1,5 +1,8 @@
 import type { CliDeps } from "./deps.js";
-import type { ActionRequired } from "./exit.js";
+import type { ActionQuestion, ActionRequired } from "./exit.js";
 import type { AgentScan } from "./types.js";
 export declare function writeAction(deps: CliDeps, action: ActionRequired): void;
+export declare const QUESTION_TOOL_HINT = "If you have a multiple-choice question tool (for example AskUserQuestion), you must ask this with it, offering exactly these options; do not ask the human to type a reply such as \"Done\". Only without such a tool, ask in plain text. Never answer for the human. Then do what the chosen option says: run its command, follow its next step, or stop.";
+/** Numbered options, the machine-readable line, and how to ask. */
+export declare function questionLines(question: ActionQuestion): string[];
 export declare function writeResume(deps: CliDeps, scanId: string, scan?: Pick<AgentScan, "eta" | "elapsedSec">): void;

package/dist/action.js

@@ -11,9 +11,33 @@ export function writeAction(deps, action) {
     if (action.code) {
         lines.push("", `Code: ${action.code}`);
     }
+    if (action.question) {
+        lines.push("", ...questionLines(action.question));
+    }
     lines.push("", "Never open, approve, or pay yourself. Never enter credentials or payment details.");
     deps.io.stderr(`${lines.join("\n")}\n`);
 }
+export const QUESTION_TOOL_HINT = "If you have a multiple-choice question tool (for example AskUserQuestion), you must ask this with it, offering exactly these options; do not ask the human to type a reply such as \"Done\". Only without such a tool, ask in plain text. Never answer for the human. Then do what the chosen option says: run its command, follow its next step, or stop.";
+/** Numbered options, the machine-readable line, and how to ask. */
+export function questionLines(question) {
+    const options = question.options.map((option, i) => {
+        const detail = option.description ? ` (${option.description})` : "";
+        const next = option.run
+            ? ` → run: ${option.run}`
+            : option.next
+                ? ` → next: ${option.next}`
+                : " → stop";
+        return `  ${i + 1}. ${option.label}${detail}${next}`;
+    });
+    return [
+        `Options:`,
+        ...options,
+        "",
+        `CLEANSLOP_QUESTION: ${JSON.stringify(question)}`,
+        "",
+        QUESTION_TOOL_HINT,
+    ];
+}
 export function writeResume(deps, scanId, scan) {
     const eta = scan ? formatEtaLine(scan) : null;
     const head = eta ? `Still running (${eta}).` : "Still running.";

package/dist/action.js.map

@@ -1 +1 @@
-{"version":3,"file":"action.js","sourceRoot":"","sources":["../src/action.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAG5C,MAAM,UAAU,WAAW,CAAC,IAAa,EAAE,MAAsB;IAC/D,MAAM,KAAK,GAAG;QACZ,8BAA8B,MAAM,CAAC,IAAI,EAAE;QAC3C,EAAE;QACF,MAAM,CAAC,WAAW;KACnB,CAAC;IACF,IAAI,MAAM,CAAC,GAAG,EAAE,CAAC;QACf,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC;IAC7B,CAAC;IACD,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC;QAChB,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;IACzC,CAAC;IACD,KAAK,CAAC,IAAI,CACR,EAAE,EACF,mFAAmF,CACpF,CAAC;IACF,IAAI,CAAC,EAAE,CAAC,MAAM,CAAC,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1C,CAAC;AAED,MAAM,UAAU,WAAW,CACzB,IAAa,EACb,MAAc,EACd,IAA4C;IAE5C,MAAM,GAAG,GAAG,IAAI,CAAC,CAAC,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IAC9C,MAAM,IAAI,GAAG,GAAG,CAAC,CAAC,CAAC,kBAAkB,GAAG,IAAI,CAAC,CAAC,CAAC,gBAAgB,CAAC;IAChE,IAAI,CAAC,EAAE,CAAC,MAAM,CACZ,GAAG,IAAI,qCAAqC,MAAM,WAAW,CAC9D,CAAC;AACJ,CAAC"}
+{"version":3,"file":"action.js","sourceRoot":"","sources":["../src/action.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAG5C,MAAM,UAAU,WAAW,CAAC,IAAa,EAAE,MAAsB;IAC/D,MAAM,KAAK,GAAG;QACZ,8BAA8B,MAAM,CAAC,IAAI,EAAE;QAC3C,EAAE;QACF,MAAM,CAAC,WAAW;KACnB,CAAC;IACF,IAAI,MAAM,CAAC,GAAG,EAAE,CAAC;QACf,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC;IAC7B,CAAC;IACD,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC;QAChB,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;IACzC,CAAC;IACD,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;QACpB,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,GAAG,aAAa,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC;IACpD,CAAC;IACD,KAAK,CAAC,IAAI,CACR,EAAE,EACF,mFAAmF,CACpF,CAAC;IACF,IAAI,CAAC,EAAE,CAAC,MAAM,CAAC,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1C,CAAC;AAED,MAAM,CAAC,MAAM,kBAAkB,GAC7B,4VAA4V,CAAC;AAE/V,mEAAmE;AACnE,MAAM,UAAU,aAAa,CAAC,QAAwB;IACpD,MAAM,OAAO,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE;QACjD,MAAM,MAAM,GAAG,MAAM,CAAC,WAAW,CAAC,CAAC,CAAC,KAAK,MAAM,CAAC,WAAW,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;QACpE,MAAM,IAAI,GAAG,MAAM,CAAC,GAAG;YACrB,CAAC,CAAC,WAAW,MAAM,CAAC,GAAG,EAAE;YACzB,CAAC,CAAC,MAAM,CAAC,IAAI;gBACX,CAAC,CAAC,YAAY,MAAM,CAAC,IAAI,EAAE;gBAC3B,CAAC,CAAC,SAAS,CAAC;QAChB,OAAO,KAAK,CAAC,GAAG,CAAC,KAAK,MAAM,CAAC,KAAK,GAAG,MAAM,GAAG,IAAI,EAAE,CAAC;IACvD,CAAC,CAAC,CAAC;IACH,OAAO;QACL,UAAU;QACV,GAAG,OAAO;QACV,EAAE;QACF,uBAAuB,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,EAAE;QACjD,EAAE;QACF,kBAAkB;KACnB,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,WAAW,CACzB,IAAa,EACb,MAAc,EACd,IAA4C;IAE5C,MAAM,GAAG,GAAG,IAAI,CAAC,CAAC,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IAC9C,MAAM,IAAI,GAAG,GAAG,CAAC,CAAC,CAAC,kBAAkB,GAAG,IAAI,CAAC,CAAC,CAAC,gBAAgB,CAAC;IAChE,IAAI,CAAC,EAAE,CAAC,MAAM,CACZ,GAAG,IAAI,qCAAqC,MAAM,WAAW,CAC9D,CAAC;AACJ,CAAC"}

package/dist/args.d.ts

@@ -1,4 +1,4 @@
 import type { ParsedArgs } from "./types.js";
 export declare function parseWaitMs(raw: string, fallback?: number): number;
 export declare function parseArgs(argv: string[], defaultWaitMs?: number): ParsedArgs;
-export declare const HELP_TEXT = "cleanslop \u2014 CleanSlop agent CLI\n\nUsage:\n  cleanslop [scan] [--wait [duration]] [--json] [--force] [--preview]\n  cleanslop login [--link] [--agree] [--no-wait | --resume]\n  cleanslop link-identity [--agree] [--no-wait | --resume]\n  cleanslop credits buy --link [--pack p5]\n  cleanslop credits buy --link --resume\n  cleanslop logout\n  cleanslop whoami\n  cleanslop status [id] [--wait [duration]]\n  cleanslop report [id] [--format md|json] [--preview]\n  cleanslop email <id> --consent \"<exact question>\" [--reply \"<human reply>\"]\n  cleanslop setup [--dry-run] [--uninstall] [--project] [--yes]\n\nscan is the default command. GitHub App repos, or a packed upload when /me\nreports uploads:true (Link). --dry-run on scan lists the upload pack.\n\nWait:\n  --wait           poll until final or the budget (default 8 minutes)\n  --wait 75m       Claude Code background budget (hours/minutes/seconds: 1h, 75m, 30s)\n  At the deadline: exit 75 and print a resume command. The scan keeps running.\n\nFlags:\n  --json           one JSON document on stdout\n  --force          skip same-commit dedupe (sends Idempotency-Key)\n  --preview        first-pass report before judgment is final\n  --no-wait        login / link-identity: print the approval link and exit 10\n  --resume         login / link-identity: continue a pending --no-wait approval\n  --link           login: Stripe Link sign-up / sign-in (requires link-cli)\n  --agree          login --link / link-identity: pass only after the human answers yes to the quoted question\n                   (--accept-terms --yes-share-email together still work for login --link; --yes-share-email for link-identity)\n  --pack           credits buy: p5, p15, or p40 (default p5). Amount and network id come from a scan 402.\n  --dry-run        setup: print the plan. scan (Link): list the pack, upload nothing\n  --uninstall      setup: remove marker blocks / skill files\n  --project        setup: project files instead of user scope\n  --yes            setup: write in a non-TTY (otherwise non-TTY is a plan only)\n  --consent        email: the exact masked-recipient question you asked\n  --reply          email: optional verbatim human reply\n\nEnv:\n  CLEANSLOP_ORIGIN   API origin (default https://cleanslop.com)\n  CLEANSLOP_TOKEN    bearer token override (never printed)\n  CLEANSLOP_LINK_CLI path to link-cli (default: link-cli on PATH)\n\nCredentials: $XDG_CONFIG_HOME/cleanslop/credentials.json or ~/.config/cleanslop/\nDirectory 0700, file 0600. Never stored inside the git worktree.\n\nExit codes: 0 ok \u00B7 1 unexpected \u00B7 2 usage \u00B7 10 human action \u00B7 11 payment\n  12 policy \u00B7 13 source \u00B7 20 scan failed \u00B7 75 still running\n\nNever open, approve, or pay yourself. Relay CLEANSLOP_ACTION_REQUIRED blocks.\n";
+export declare const HELP_TEXT = "cleanslop \u2014 CleanSlop agent CLI\n\nUsage:\n  cleanslop [scan] [--wait [duration]] [--json] [--force] [--preview] [--upload]\n  cleanslop login [--link] [--agree] [--no-wait | --resume]\n  cleanslop link-identity [--agree] [--no-wait | --resume]\n  cleanslop credits buy --link [--pack p5] [--no-promo] [--no-wait | --resume]\n  cleanslop redeem <code>\n  cleanslop logout [--all]\n  cleanslop whoami\n  cleanslop status [id] [--wait [duration]]\n  cleanslop report [id] [--format md|json] [--preview]\n  cleanslop email <id> --consent \"<exact question>\" [--reply \"<human reply>\"]\n  cleanslop setup [--dry-run] [--uninstall] [--project] [--yes]\n\nscan is the default command. GitHub App repos, or a packed upload when /me\nreports uploads:true (Link). With uploadFallback:true (GitHub), a checkout\nwith no GitHub origin uploads its files, and a dirty or unpushed one asks\nwhether to upload them or push first. --dry-run on scan lists the upload pack.\n\nWait:\n  --wait           poll until final or the budget (default 8 minutes)\n  --wait 75m       Claude Code background budget (hours/minutes/seconds: 1h, 75m, 30s)\n  At the deadline: exit 75 and print a resume command. The scan keeps running.\n\nFlags:\n  --json           one JSON document on stdout\n  --force          skip same-commit dedupe (sends Idempotency-Key)\n  --preview        first-pass report before judgment is final\n  --upload         scan: upload the local files instead of the pushed commit (after the human picks it)\n  --no-wait        login / link-identity / credits buy: print what to approve and exit 10\n  --resume         login / link-identity / credits buy: continue a pending --no-wait approval\n  --link           login: Stripe Link sign-up / sign-in (requires link-cli)\n  --agree          login --link / link-identity: pass only after the human answers yes to the quoted question\n                   (--accept-terms --yes-share-email together still work for login --link; --yes-share-email for link-identity)\n  --pack           credits buy: p5, p15, or p40. Required without a terminal (the human picks); a terminal defaults to p5. Price and network id come from CleanSlop.\n  --no-promo       credits buy: skip the promo-code choice (the human already chose to buy)\n  --all            logout: revoke every saved token and delete all local CleanSlop data\n                   (without it, logout signs out of this origin and drops its pending login and Link payment)\n  --dry-run        setup: print the plan. scan (upload): list the pack, upload nothing\n  --uninstall      setup: remove marker blocks / skill files\n  --project        setup: project files instead of user scope\n  --yes            setup: write in a non-TTY (otherwise non-TTY is a plan only)\n  --consent        email: the exact masked-recipient question you asked\n  --reply          email: optional verbatim human reply\n\nEnv:\n  CLEANSLOP_ORIGIN   API origin (default https://cleanslop.com)\n  CLEANSLOP_TOKEN    bearer token override (never printed)\n  CLEANSLOP_LINK_CLI path to link-cli (default: link-cli on PATH)\n\nCredentials: $XDG_CONFIG_HOME/cleanslop/credentials.json or ~/.config/cleanslop/\nDirectory 0700, file 0600. Never stored inside the git worktree.\n\nExit codes: 0 ok \u00B7 1 unexpected \u00B7 2 usage \u00B7 10 human action \u00B7 11 payment\n  12 policy \u00B7 13 source \u00B7 20 scan failed \u00B7 75 still running\n\nNever open, approve, or pay yourself. Relay CLEANSLOP_ACTION_REQUIRED blocks.\nAsk a CLEANSLOP_QUESTION with your multiple-choice question tool when you have\none (never ask the human to type \"Done\"), using exactly its options. Never\nanswer for the human.\n";

package/dist/args.js

@@ -11,6 +11,7 @@ const COMMANDS = [
     "email",
     "link-identity",
     "credits",
+    "redeem",
 ];
 function isCommand(value) {
     return COMMANDS.includes(value);
@@ -38,12 +39,15 @@ function emptyArgs(defaultWaitMs) {
         wait: false,
         waitMs: defaultWaitMs,
         noWait: false,
+        noPromo: false,
         resume: false,
         force: false,
+        upload: false,
         preview: false,
         format: "md",
         dryRun: false,
         uninstall: false,
+        all: false,
         project: false,
         yes: false,
         consent: null,
@@ -85,9 +89,15 @@ export function parseArgs(argv, defaultWaitMs = DEFAULT_WAIT_MS) {
             case "--resume":
                 out.resume = true;
                 break;
+            case "--no-promo":
+                out.noPromo = true;
+                break;
             case "--force":
                 out.force = true;
                 break;
+            case "--upload":
+                out.upload = true;
+                break;
             case "--preview":
                 out.preview = true;
                 break;
@@ -97,6 +107,9 @@ export function parseArgs(argv, defaultWaitMs = DEFAULT_WAIT_MS) {
             case "--uninstall":
                 out.uninstall = true;
                 break;
+            case "--all":
+                out.all = true;
+                break;
             case "--project":
                 out.project = true;
                 break;
@@ -194,12 +207,12 @@ export function parseArgs(argv, defaultWaitMs = DEFAULT_WAIT_MS) {
 export const HELP_TEXT = `cleanslop — CleanSlop agent CLI
 
 Usage:
-  cleanslop [scan] [--wait [duration]] [--json] [--force] [--preview]
+  cleanslop [scan] [--wait [duration]] [--json] [--force] [--preview] [--upload]
   cleanslop login [--link] [--agree] [--no-wait | --resume]
   cleanslop link-identity [--agree] [--no-wait | --resume]
-  cleanslop credits buy --link [--pack p5]
-  cleanslop credits buy --link --resume
-  cleanslop logout
+  cleanslop credits buy --link [--pack p5] [--no-promo] [--no-wait | --resume]
+  cleanslop redeem <code>
+  cleanslop logout [--all]
   cleanslop whoami
   cleanslop status [id] [--wait [duration]]
   cleanslop report [id] [--format md|json] [--preview]
@@ -207,7 +220,9 @@ Usage:
   cleanslop setup [--dry-run] [--uninstall] [--project] [--yes]
 
 scan is the default command. GitHub App repos, or a packed upload when /me
-reports uploads:true (Link). --dry-run on scan lists the upload pack.
+reports uploads:true (Link). With uploadFallback:true (GitHub), a checkout
+with no GitHub origin uploads its files, and a dirty or unpushed one asks
+whether to upload them or push first. --dry-run on scan lists the upload pack.
 
 Wait:
   --wait           poll until final or the budget (default 8 minutes)
@@ -218,13 +233,17 @@ Flags:
   --json           one JSON document on stdout
   --force          skip same-commit dedupe (sends Idempotency-Key)
   --preview        first-pass report before judgment is final
-  --no-wait        login / link-identity: print the approval link and exit 10
-  --resume         login / link-identity: continue a pending --no-wait approval
+  --upload         scan: upload the local files instead of the pushed commit (after the human picks it)
+  --no-wait        login / link-identity / credits buy: print what to approve and exit 10
+  --resume         login / link-identity / credits buy: continue a pending --no-wait approval
   --link           login: Stripe Link sign-up / sign-in (requires link-cli)
   --agree          login --link / link-identity: pass only after the human answers yes to the quoted question
                    (--accept-terms --yes-share-email together still work for login --link; --yes-share-email for link-identity)
-  --pack           credits buy: p5, p15, or p40 (default p5). Amount and network id come from a scan 402.
-  --dry-run        setup: print the plan. scan (Link): list the pack, upload nothing
+  --pack           credits buy: p5, p15, or p40. Required without a terminal (the human picks); a terminal defaults to p5. Price and network id come from CleanSlop.
+  --no-promo       credits buy: skip the promo-code choice (the human already chose to buy)
+  --all            logout: revoke every saved token and delete all local CleanSlop data
+                   (without it, logout signs out of this origin and drops its pending login and Link payment)
+  --dry-run        setup: print the plan. scan (upload): list the pack, upload nothing
   --uninstall      setup: remove marker blocks / skill files
   --project        setup: project files instead of user scope
   --yes            setup: write in a non-TTY (otherwise non-TTY is a plan only)
@@ -243,5 +262,8 @@ Exit codes: 0 ok · 1 unexpected · 2 usage · 10 human action · 11 payment
   12 policy · 13 source · 20 scan failed · 75 still running
 
 Never open, approve, or pay yourself. Relay CLEANSLOP_ACTION_REQUIRED blocks.
+Ask a CLEANSLOP_QUESTION with your multiple-choice question tool when you have
+one (never ask the human to type "Done"), using exactly its options. Never
+answer for the human.
 `;
 //# sourceMappingURL=args.js.map

package/dist/args.js.map

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

package/dist/commands/credits.d.ts

@@ -12,18 +12,47 @@ export type StripeSptOffer = {
     currency: string;
     networkId: string;
     purchaseUrl: string;
+    /** CleanSlop marks one pack as the best value. */
+    best?: boolean;
 };
 /** Fixed Link approval budget. Auto-buy ignores `scan --wait`. */
 export declare const LINK_APPROVAL_WAIT_MS: number;
+/**
+ * `--resume` budget. The human has usually approved already; anything longer
+ * would outlast an agent's foreground shell call.
+ */
+export declare const LINK_RESUME_WAIT_MS: number;
+/**
+ * How long to poll Link for approval. `--no-wait` checks once, `--resume`
+ * polls briefly, and the default (a human at a terminal) waits 10 minutes.
+ */
 export declare function linkApprovalWaitMs(args: ParsedArgs, opts?: {
     autoBuy?: boolean;
 }): number;
+/** Cents to a display price, e.g. `5.00 USD`. */
+export declare function formatPackPrice(amount: number, currency: string): string;
+/** `p15 (15 scans, 25.00 USD, 1.67 USD per scan, best value)`. */
+export declare function describePackOffer(offer: StripeSptOffer): string;
+/** Every `stripe_spt` offer in a 402 `out_of_scans` body, in server order. */
+export declare function stripeSptOffersFromErrorBody(json: unknown): StripeSptOffer[];
 /** Read a matching `stripe_spt` offer from a 402 `out_of_scans` body. */
 export declare function stripeSptOfferFromErrorBody(json: unknown, packHint: string | null): StripeSptOffer | null;
+/**
+ * Buys a Link credit pack. Default mode (a human at a terminal) creates the
+ * spend request and waits up to 10 minutes. `--no-wait` creates it (or checks
+ * the saved one), prints the approve block, and exits 10; `--resume` finishes
+ * the saved request. A saved request for this origin is always reused rather
+ * than replaced, so retries never send the person a second approval.
+ */
 export declare function buyLinkCredits(deps: CliDeps, args: ParsedArgs, offer?: StripeSptOffer | null, opts?: {
     autoBuy?: boolean;
 }): Promise<number>;
 export declare function runCredits(deps: CliDeps, args: ParsedArgs): Promise<number>;
-/** If a scan 402 offers `stripe_spt`, buy that pack and retry the scan once. */
+/**
+ * If a scan 402 offers `stripe_spt`: a human at a terminal buys that pack in
+ * place and the scan retries once. An agent (no TTY) gets a top-up block that
+ * sends it through `credits buy --link --no-wait` / `--resume`, because a
+ * 10-minute approval wait outlasts its shell call.
+ */
 export declare function recoverOutOfScansIfOffered(deps: CliDeps, args: ParsedArgs, result: HttpResult, retry: () => Promise<HttpResult>): Promise<HttpResult>;
 export {};