@ashlr/hub 3.10.1 → 3.11.2

package/dist/authority-surface.json

@@ -194,6 +194,61 @@
       "sha256": "d1a8b5532c5d03ecc7835dea9b3751de7a36fbc3c13be2cdc299a8f5ef1921d0",
       "bytes": 18568
     },
+    {
+      "path": "dist/core/cloud/backlog.js",
+      "sha256": "7e590b92e595d0803c19432974870c06da4ffc5797f66e0d9eb2e7684069e91c",
+      "bytes": 8186
+    },
+    {
+      "path": "dist/core/cloud/budget.js",
+      "sha256": "68362ee6c3d7c8bbdce41d2e51383e76fd604b8a29e3a8d333eb9cce5c103e2d",
+      "bytes": 5034
+    },
+    {
+      "path": "dist/core/cloud/checkout.js",
+      "sha256": "23c809eac408aa8502111f9f9cf4a74b76998caab804dd600c1c2f39ed82ea69",
+      "bytes": 8076
+    },
+    {
+      "path": "dist/core/cloud/cloud-api.js",
+      "sha256": "f56466058c2a932af45349b2fe9d137b97e2466bea4897d271c84607c8e3cab0",
+      "bytes": 25620
+    },
+    {
+      "path": "dist/core/cloud/delivery-contract.js",
+      "sha256": "ea8bb76f0cb6b6731ebe1245291a3191670bdf9a8b0963ec2060b3141d8f9e2f",
+      "bytes": 6714
+    },
+    {
+      "path": "dist/core/cloud/improvement-backlog.js",
+      "sha256": "d6609600e539c6d3db94d91c947250e7995895dc27939d1d0c7f86604ee9d4db",
+      "bytes": 9462
+    },
+    {
+      "path": "dist/core/cloud/launcher.js",
+      "sha256": "a8949f1b3e5d5ebdad5e56929abda2034c4c17dd0f8ddf825fd17d2d5b3296de",
+      "bytes": 15055
+    },
+    {
+      "path": "dist/core/cloud/service.js",
+      "sha256": "d07028772d97533de87b6042ae9a5a60176e13538416236b84f70c93a7248e7e",
+      "bytes": 10730
+    },
+    {
+      "path": "dist/core/cloud/store.js",
+      "sha256": "fc56141115fbae8b3215d4fa944a572076e18a8030a619fe0d7e15f94632b307",
+      "bytes": 13524
+    },
+    {
+      "path": "dist/core/cloud/tracker.js",
+      "sha256": "a076198b200de95872a812d39fd10804a8bced2756a7bd382e5eec24c98a4b03",
+      "bytes": 6969
+    },
+    {
+      "path": "dist/core/cloud/types.js",
+      "sha256": "30b3823fea97bce3f40e28aac35bd4d9915d0eae26bfb73509a901b440adcfaa",
+      "bytes": 4202
+    },
     {
       "path": "dist/core/comms/director-context.js",
       "sha256": "f08d2887833ba4d7eb42d6ed19f15d3ffd082c44ef50d871567b0fc3ee1fe966",
@@ -2186,8 +2241,8 @@
     },
     {
       "path": "dist/core/universe/campaign.js",
-      "sha256": "0b26b7fec61b4da85ea4ebe7a301eeafbf0d624cc013890dbba3159cea83e44f",
-      "bytes": 18894
+      "sha256": "5cce2297b8cd587090858a92d94ab5d74c2518cfe0147ff8c5a40d71729107f5",
+      "bytes": 19515
     },
     {
       "path": "dist/core/universe/cold-verifier.js",
@@ -2461,8 +2516,8 @@
     },
     {
       "path": "dist/core/universe/runner.js",
-      "sha256": "dc77b6feb06dcd7d8608b8d0df384ce0ae1c0b9b8b9b4d20585d779e751c02cb",
-      "bytes": 33629
+      "sha256": "2c7441abff55cae1518b50f6d664767cbd605bb3ce440d1789331f82b59f1909",
+      "bytes": 33928
     },
     {
       "path": "dist/core/universe/search-context.js",
@@ -2561,13 +2616,13 @@
     },
     {
       "path": "dist/core/verse/activity-api.js",
-      "sha256": "95be999a7ee7238fd08c36102c9a5237c74c96bf72bbee2222ba2e3c0ca3df96",
-      "bytes": 13581
+      "sha256": "812524849c0215f29cb60365cb5320197deaf7f47b797009805980e02443f77c",
+      "bytes": 14046
     },
     {
       "path": "dist/core/verse/activity.js",
-      "sha256": "5d5b5c9974fbaf906e7b7b917b4c5351442059b49d38b291ac39e13997dccb2e",
-      "bytes": 30334
+      "sha256": "2adf795b5d4920a9871c8cd632cdfbe48b1027a231f18b7c9eaab9dcfc91af36",
+      "bytes": 31483
     },
     {
       "path": "dist/core/verse/adapters/claude.js",
@@ -2624,6 +2679,11 @@
       "sha256": "2bc584f8aa2d88c654d691a552c62f63c36da62b687443bbcffd5d9d508c6659",
       "bytes": 32706
     },
+    {
+      "path": "dist/core/verse/compaction-point.js",
+      "sha256": "526968e0ce4b138f3cf41e47cd51a74ec7bffd0d75630f959814e54e9991bb34",
+      "bytes": 3848
+    },
     {
       "path": "dist/core/verse/context-fit.js",
       "sha256": "526164f640a353af0d92962246455b0fa86e5077811a42bcd4719c91895e0066",
@@ -2631,8 +2691,8 @@
     },
     {
       "path": "dist/core/verse/context-math.js",
-      "sha256": "892245d0d72310f90a14f72c5cd3096b3510d9a2f7358b00b0610965e4bfa5d4",
-      "bytes": 17912
+      "sha256": "2fe62b622104619d846dc347b12c69f0331cbb94fd60f59a0e9733ce1e54966e",
+      "bytes": 15497
     },
     {
       "path": "dist/core/verse/control-api.js",
@@ -2866,8 +2926,8 @@
     },
     {
       "path": "dist/core/verse/verse-api.js",
-      "sha256": "9417d0979eaaf1974fd849cd935d813eed566d92951a1a23484782bcd608a344",
-      "bytes": 89355
+      "sha256": "830541b9a742edaf8ce9ee78a0ed8c528f22726d0117e3bec74340f3bfa4b394",
+      "bytes": 89520
     },
     {
       "path": "dist/core/verse/verse-log.js",
@@ -2944,6 +3004,11 @@
       "sha256": "8a55d8f6ef3675573825d8d9f418f6fae9742bc0a964299765cc672803e879c9",
       "bytes": 84506
     },
+    {
+      "path": "dist/core/vision/leader-cloud.js",
+      "sha256": "4b999d47bc2d355ae0b15c5994d53e3d3129d545d3a6c59aeebfb4e099f9e621",
+      "bytes": 5893
+    },
     {
       "path": "dist/core/vision/leader-memo.js",
       "sha256": "33170fd58336016aa4b89bbfdf808a2e6154e84fbb4b0f606ae137d6c176fcad",
@@ -2961,8 +3026,8 @@
     },
     {
       "path": "dist/core/vision/leader.js",
-      "sha256": "643134544872872a6c260f2774ecc3483d7e6726c84dc84a4e882feca8135149",
-      "bytes": 39571
+      "sha256": "7cfa353f85882542fd4f5009d3d4ae768aed4f209b7195fd1b7ccc019b92a181",
+      "bytes": 40229
     },
     {
       "path": "dist/core/vision/mission-graph.js",
@@ -3091,5 +3156,5 @@
     "dist/core/swarm/runner.js -> import(<computed>) x3",
     "dist/core/verse/session-engine.js -> import(<computed>) x1"
   ],
-  "digest": "8745b1609150c6f0b0b8812eb881cba2530bc4dbe2f5b1045c2f4ea58ba2c70d"
+  "digest": "248347e536e2686f44efc28018752e0679f0987e70b45932448d613536d43135"
 }

package/dist/build-identity.json

@@ -1,7 +1,7 @@
 {
   "schemaVersion": 1,
-  "packageVersion": "3.10.1",
-  "revision": "01519cf87386a9a55eca5611a5ec2243e84464a5",
+  "packageVersion": "3.11.2",
+  "revision": "c6ecafc73acd5c64c236362157b5ba854b0df219",
   "dirty": false,
   "provenance": "git"
 }

package/dist/cli/cloud.d.ts

@@ -0,0 +1,39 @@
+import type { CloudBacklogView, CloudBudgetUpdate, CloudBudgetV1, CloudBudgetView, CloudImproveResponse, CloudLaunchRequest, CloudLaunchResponse, CloudSeatStatus, CloudTaskV1 } from '../core/cloud/types.js';
+export interface CloudCliDeps {
+    launch: (req: CloudLaunchRequest) => Promise<CloudLaunchResponse>;
+    listTasks: (limit?: number) => CloudTaskV1[];
+    readBudget: () => CloudBudgetV1;
+    updateBudget: (update: CloudBudgetUpdate) => CloudBudgetV1;
+    budgetView: (tasks: readonly CloudTaskV1[], budget: CloudBudgetV1, now: Date) => CloudBudgetView;
+    refresh: () => Promise<{
+        checked: number;
+        updated: number;
+    }>;
+    improve: (opts: {
+        count?: number;
+        auto: boolean;
+    }) => Promise<CloudImproveResponse>;
+    backlog: (tasks: readonly CloudTaskV1[], now: Date) => CloudBacklogView;
+    seat: () => CloudSeatStatus;
+    /** `owner/name` of the folder's GitHub origin, or null. */
+    originRepo: (cwd: string) => string | null;
+    cwd: () => string;
+    now: () => Date;
+    out: (line: string) => void;
+    err: (line: string) => void;
+    color: boolean;
+}
+/**
+ * `owner/name` from a GitHub remote URL — https, scp-style ssh and ssh://
+ * forms, with or without `.git`. Null for anything that is not github.com:
+ * a cloud session can only clone from GitHub.
+ */
+export declare function parseGithubRepo(url: string): string | null;
+/** "today 2:05 PM", "yesterday 9:40 AM", "Sep 21 4:00 PM" — the operator's local time, never ISO. */
+export declare function localWhen(iso: string | null | undefined, now: Date): string;
+export declare function usd(value: number): string;
+/** Tasks `list` shows: everything in flight plus what finished recently; `all` shows every task. */
+export declare function tasksToList(tasks: readonly CloudTaskV1[], now: Date, all: boolean): CloudTaskV1[];
+/** Budget flags → a CloudBudgetUpdate (empty when no flag was given). Exported for tests. */
+export declare function parseBudgetFlags(args: string[]): CloudBudgetUpdate;
+export declare function runCloudCli(argv: string[], injected?: Partial<CloudCliDeps>): Promise<number>;

package/dist/cli/cloud.js

@@ -0,0 +1,448 @@
+/**
+ * `ashlr cloud` — the 3.11 cloud lane (unit C2): launch Claude Code cloud
+ * sessions that deliver a draft PR, track them, and keep spend inside the
+ * operator's budget.
+ *
+ *   ashlr cloud launch "<task>" [--repo owner/name] [--base branch] [--title t] [--json]
+ *   ashlr cloud list [--all] [--json]
+ *   ashlr cloud refresh [--json]
+ *   ashlr cloud improve [--count N] [--json]
+ *   ashlr cloud budget [--total N] [--spent N] [--per-session N] [--max-per-day N]
+ *                      [--max-concurrent N] [--self-improve on|off]
+ *                      [--self-improve-max N] [--reserve N] [--json]
+ *   ashlr cloud backlog [--json]
+ *
+ * Talks to the cloud service in-process (src/core/cloud/*), NOT to the Verse
+ * server, and never imports cloud-api.ts — that module starts the background
+ * scheduler, which belongs to the long-running server, not to a one-shot CLI.
+ *
+ * Output is for people: local times, no ISO stamps, no absolute paths.
+ * `--json` prints the service's own shapes for scripts. `launch` and
+ * `improve` start real cloud sessions that spend Claude credits (an estimate
+ * is charged against the budget); nothing here ever merges.
+ * Exit codes: 0 success, 1 error / refused, 2 bad usage.
+ */
+import { execFileSync } from 'node:child_process';
+import { makeColors, isTty } from './ui.js';
+const USAGE = `ashlr cloud — Claude Code cloud sessions that deliver draft PRs
+
+Usage:
+  ashlr cloud launch "<task>" [--repo owner/name] [--base branch] [--title "short title"] [--json]
+      Start a cloud session on the task. The repo defaults to this folder's GitHub origin.
+  ashlr cloud list [--all] [--json]
+      Tasks in flight and recently finished (--all: every task).
+  ashlr cloud refresh [--json]
+      Ask GitHub for each open task's pull request now.
+  ashlr cloud improve [--count N] [--json]
+      Launch the next N (1–5, default 1) self-improvement backlog items.
+  ashlr cloud budget [--total N] [--spent N] [--per-session N] [--max-per-day N] [--max-concurrent N]
+                     [--self-improve on|off] [--self-improve-max N] [--reserve N] [--json]
+      Show the estimated credits and limits; any flag updates them first.
+  ashlr cloud backlog [--json]
+      The self-improvement backlog and what each item's latest task did.
+
+Spend is an estimate: Claude doesn't expose the credit balance.`;
+async function defaultDeps() {
+    const [service, store, budget, backlog, tracker] = await Promise.all([
+        import('../core/cloud/service.js'),
+        import('../core/cloud/store.js'),
+        import('../core/cloud/budget.js'),
+        import('../core/cloud/backlog.js'),
+        import('../core/cloud/tracker.js'),
+    ]);
+    return {
+        launch: (req) => service.launchCloudTask(req),
+        listTasks: (limit) => store.listCloudTasks(limit),
+        readBudget: () => store.readCloudBudget(),
+        updateBudget: (update) => store.updateCloudBudget(update),
+        budgetView: (tasks, b, now) => budget.cloudBudgetView(tasks, b, now),
+        refresh: () => tracker.refreshCloudTasks(),
+        improve: (opts) => service.runSelfImprove(opts),
+        backlog: (tasks, now) => backlog.readCloudBacklog(tasks, now),
+        seat: () => service.cloudSeatStatus(),
+        originRepo: readOriginRepo,
+        cwd: () => process.cwd(),
+        now: () => new Date(),
+        out: (line) => console.log(line),
+        err: (line) => console.error(line),
+        color: isTty(),
+    };
+}
+// ---------------------------------------------------------------------------
+// Pure helpers (exported for tests)
+// ---------------------------------------------------------------------------
+/**
+ * `owner/name` from a GitHub remote URL — https, scp-style ssh and ssh://
+ * forms, with or without `.git`. Null for anything that is not github.com:
+ * a cloud session can only clone from GitHub.
+ */
+export function parseGithubRepo(url) {
+    const trimmed = url.trim();
+    const m = /^(?:https?:\/\/(?:[^@/]+@)?github\.com\/|git@github\.com:|ssh:\/\/git@github\.com(?::\d+)?\/)([A-Za-z0-9-]+)\/([A-Za-z0-9._-]+?)(?:\.git)?\/?$/.exec(trimmed);
+    if (!m)
+        return null;
+    return `${m[1]}/${m[2]}`;
+}
+function readOriginRepo(cwd) {
+    try {
+        const url = execFileSync('git', ['remote', 'get-url', 'origin'], {
+            cwd,
+            encoding: 'utf8',
+            stdio: ['ignore', 'pipe', 'ignore'],
+            timeout: 5_000,
+        });
+        return parseGithubRepo(url);
+    }
+    catch {
+        return null;
+    }
+}
+function sameLocalDay(a, b) {
+    return a.getFullYear() === b.getFullYear() && a.getMonth() === b.getMonth() && a.getDate() === b.getDate();
+}
+/** "today 2:05 PM", "yesterday 9:40 AM", "Sep 21 4:00 PM" — the operator's local time, never ISO. */
+export function localWhen(iso, now) {
+    if (!iso)
+        return 'unknown time';
+    const at = new Date(iso);
+    if (Number.isNaN(at.getTime()))
+        return 'unknown time';
+    const time = at.toLocaleTimeString('en-US', { hour: 'numeric', minute: '2-digit' });
+    if (sameLocalDay(at, now))
+        return `today ${time}`;
+    const yesterday = new Date(now.getFullYear(), now.getMonth(), now.getDate() - 1);
+    if (sameLocalDay(at, yesterday))
+        return `yesterday ${time}`;
+    const day = at.toLocaleDateString('en-US', {
+        month: 'short',
+        day: 'numeric',
+        ...(at.getFullYear() === now.getFullYear() ? {} : { year: 'numeric' }),
+    });
+    return `${day} ${time}`;
+}
+export function usd(value) {
+    return `$${value.toFixed(2)}`;
+}
+const TERMINAL = new Set(['merged', 'closed', 'failed', 'expired']);
+/** Default `list` window for finished tasks. */
+const RECENT_MS = 3 * 24 * 60 * 60 * 1000;
+const STATE_LABEL = {
+    queued: 'queued',
+    launching: 'launching',
+    running: 'running',
+    'pr-open': 'PR open',
+    merged: 'merged',
+    closed: 'closed',
+    failed: 'failed',
+    expired: 'expired',
+};
+/** Tasks `list` shows: everything in flight plus what finished recently; `all` shows every task. */
+export function tasksToList(tasks, now, all) {
+    if (all)
+        return [...tasks];
+    return tasks.filter((t) => {
+        if (!TERMINAL.has(t.state))
+            return true;
+        const at = Date.parse(t.updatedAt);
+        return !Number.isNaN(at) && now.getTime() - at <= RECENT_MS;
+    });
+}
+// ---------------------------------------------------------------------------
+// Argument parsing
+// ---------------------------------------------------------------------------
+class UsageError extends Error {
+}
+function takeFlag(args, name) {
+    const i = args.indexOf(name);
+    if (i === -1)
+        return false;
+    args.splice(i, 1);
+    return true;
+}
+function takeOption(args, name) {
+    const i = args.indexOf(name);
+    if (i === -1)
+        return null;
+    const value = args[i + 1];
+    if (value === undefined || value.startsWith('--'))
+        throw new UsageError(`${name} needs a value.`);
+    args.splice(i, 2);
+    return value;
+}
+function takeNumber(args, name, whole) {
+    const raw = takeOption(args, name);
+    if (raw === null)
+        return null;
+    const value = Number(raw.replace(/^\$/, ''));
+    if (raw.trim() === '' || !Number.isFinite(value) || value < 0)
+        throw new UsageError(`${name} must be a number of zero or more.`);
+    if (whole && !Number.isInteger(value))
+        throw new UsageError(`${name} must be a whole number.`);
+    return value;
+}
+function rejectLeftovers(args) {
+    const unknown = args.find((a) => a.startsWith('-'));
+    if (unknown)
+        throw new UsageError(`Unknown option ${unknown}.`);
+    if (args.length > 0)
+        throw new UsageError(`Unexpected argument "${args[0]}".`);
+}
+/** Budget flags → a CloudBudgetUpdate (empty when no flag was given). Exported for tests. */
+export function parseBudgetFlags(args) {
+    const update = {};
+    const total = takeNumber(args, '--total', false);
+    if (total !== null)
+        update.creditsTotalUsd = total;
+    const spent = takeNumber(args, '--spent', false);
+    if (spent !== null)
+        update.creditsSpentAdjustmentUsd = spent;
+    const perSession = takeNumber(args, '--per-session', false);
+    if (perSession !== null)
+        update.estimatedCostPerSessionUsd = perSession;
+    const perDay = takeNumber(args, '--max-per-day', true);
+    if (perDay !== null)
+        update.maxSessionsPerDay = perDay;
+    const concurrent = takeNumber(args, '--max-concurrent', true);
+    if (concurrent !== null)
+        update.maxConcurrent = concurrent;
+    const self = {};
+    const toggle = takeOption(args, '--self-improve');
+    if (toggle !== null) {
+        if (toggle !== 'on' && toggle !== 'off')
+            throw new UsageError('--self-improve takes on or off.');
+        self.enabled = toggle === 'on';
+    }
+    const selfMax = takeNumber(args, '--self-improve-max', true);
+    if (selfMax !== null)
+        self.maxPerDay = selfMax;
+    const reserve = takeNumber(args, '--reserve', false);
+    if (reserve !== null)
+        self.reserveUsd = reserve;
+    if (Object.keys(self).length > 0)
+        update.selfImprove = self;
+    return update;
+}
+// ---------------------------------------------------------------------------
+// Printing
+// ---------------------------------------------------------------------------
+function printTask(deps, task) {
+    const c = makeColors(deps.color);
+    const now = deps.now();
+    const tone = task.state === 'failed' ? c.red : task.state === 'pr-open' ? c.green : TERMINAL.has(task.state) ? c.dim : c.cyan;
+    deps.out(`${tone(STATE_LABEL[task.state].padEnd(9))}  ${task.title}`);
+    const facts = [task.repo, `started ${localWhen(task.createdAt, now)}`];
+    if (task.state !== 'queued' && task.state !== 'launching' && !TERMINAL.has(task.state)) {
+        facts.push(`updated ${localWhen(task.updatedAt, now)}`);
+    }
+    deps.out(`           ${c.dim(facts.join(' · '))}  ${c.dim(task.id)}`);
+    if (task.pr)
+        deps.out(`           PR #${task.pr.number}: ${task.pr.url}`);
+    else if (task.sessionUrl)
+        deps.out(`           Session: ${task.sessionUrl}`);
+    if (task.report)
+        deps.out(`           Report (${task.report.status}): ${task.report.summary}`);
+    if (task.stateReason)
+        deps.out(`           ${task.stateReason}`);
+}
+function gateLine(ok, reason) {
+    return ok ? 'allowed' : `blocked — ${reason ?? 'no reason given'}`;
+}
+function printBudget(view, out) {
+    const b = view.budget;
+    out(`Cloud credits (estimate): ${usd(view.estimatedRemainingUsd)} of ${usd(view.creditsTotalUsd)} left · ${usd(view.estimatedSpentUsd)} spent`);
+    out(`  ${view.estimateNote}`);
+    out(`  Real balance: ${view.balanceUrl}`);
+    out(`Sessions today: ${view.sessionsToday} of ${b.maxSessionsPerDay} · running now: ${view.running} of ${b.maxConcurrent} at once`);
+    out(`  Estimated cost per session: ${usd(b.estimatedCostPerSessionUsd)}${b.creditsSpentAdjustmentUsd > 0 ? ` · spent before tracking: ${usd(b.creditsSpentAdjustmentUsd)}` : ''}`);
+    const self = b.selfImprove;
+    out(`Self-improvement: ${self.enabled ? 'on' : 'off'} · ${view.selfImproveToday} of ${self.maxPerDay} today · ${self.repo} · pauses below ${usd(self.reserveUsd)} left`);
+    out(`Launch now: ${gateLine(view.canLaunch.ok, view.canLaunch.reason)}`);
+    out(`Self-improve now: ${gateLine(view.canSelfImprove.ok, view.canSelfImprove.reason)}`);
+}
+function json(deps, value) {
+    deps.out(JSON.stringify(value, null, 2));
+}
+// ---------------------------------------------------------------------------
+// Subcommands
+// ---------------------------------------------------------------------------
+async function cmdLaunch(deps, args) {
+    const asJson = takeFlag(args, '--json');
+    const repoFlag = takeOption(args, '--repo');
+    const base = takeOption(args, '--base');
+    const title = takeOption(args, '--title');
+    const unknown = args.find((a) => a.startsWith('--'));
+    if (unknown)
+        throw new UsageError(`Unknown option ${unknown}.`);
+    const prompt = args.join(' ').trim();
+    if (!prompt)
+        throw new UsageError('Describe the task: ashlr cloud launch "<task>".');
+    const repo = repoFlag ?? deps.originRepo(deps.cwd());
+    if (!repo) {
+        deps.err('This folder has no GitHub origin. Pass --repo owner/name.');
+        return 2;
+    }
+    const req = { repo, prompt, origin: 'cli' };
+    if (base !== null)
+        req.baseBranch = base;
+    if (title !== null)
+        req.title = title;
+    const result = await deps.launch(req);
+    if (asJson) {
+        json(deps, result);
+        return result.ok ? 0 : 1;
+    }
+    if (!result.ok || !result.task) {
+        deps.err(`Not launched: ${result.error ?? 'the cloud session could not be started.'}`);
+        return 1;
+    }
+    const task = result.task;
+    deps.out(`Launched cloud task: ${task.title}`);
+    if (task.sessionUrl)
+        deps.out(`  Open in Claude: ${task.sessionUrl}`);
+    deps.out(`  It delivers a draft PR from branch ${task.branch} into ${task.baseBranch} on ${task.repo}.`);
+    deps.out(`  Estimated cost: ${usd(task.estimatedCostUsd)}. Track it with: ashlr cloud list`);
+    return 0;
+}
+function cmdList(deps, args) {
+    const asJson = takeFlag(args, '--json');
+    const all = takeFlag(args, '--all');
+    rejectLeftovers(args);
+    const tasks = tasksToList(deps.listTasks(all ? 500 : undefined), deps.now(), all);
+    if (asJson) {
+        json(deps, tasks);
+        return 0;
+    }
+    if (tasks.length === 0) {
+        deps.out(all ? 'No cloud tasks yet.' : 'No cloud tasks in flight or finished in the last 3 days. Use --all for older ones.');
+        return 0;
+    }
+    for (const task of tasks)
+        printTask(deps, task);
+    return 0;
+}
+async function cmdRefresh(deps, args) {
+    const asJson = takeFlag(args, '--json');
+    rejectLeftovers(args);
+    const result = await deps.refresh();
+    if (asJson)
+        json(deps, result);
+    else
+        deps.out(`Checked ${result.checked} ${result.checked === 1 ? 'task' : 'tasks'} on GitHub; ${result.updated} changed.`);
+    return 0;
+}
+async function cmdImprove(deps, args) {
+    const asJson = takeFlag(args, '--json');
+    const count = takeNumber(args, '--count', true);
+    rejectLeftovers(args);
+    if (count !== null && (count < 1 || count > 5))
+        throw new UsageError('--count must be from 1 to 5.');
+    const result = await deps.improve({ count: count ?? 1, auto: false });
+    if (asJson) {
+        json(deps, result);
+        return result.launched.length > 0 || result.skipped.length === 0 ? 0 : 1;
+    }
+    if (result.launched.length === 0 && result.skipped.length === 0) {
+        deps.out('Nothing to launch: the backlog has no available items.');
+        return 0;
+    }
+    for (const task of result.launched) {
+        deps.out(`Launched: ${task.title}${task.sessionUrl ? ` — ${task.sessionUrl}` : ''}`);
+    }
+    for (const skip of result.skipped)
+        deps.out(`Skipped ${skip.itemId}: ${skip.reason}`);
+    return result.launched.length > 0 ? 0 : 1;
+}
+function cmdBudget(deps, args) {
+    const asJson = takeFlag(args, '--json');
+    const update = parseBudgetFlags(args);
+    rejectLeftovers(args);
+    const budget = Object.keys(update).length > 0 ? deps.updateBudget(update) : deps.readBudget();
+    const view = deps.budgetView(deps.listTasks(), budget, deps.now());
+    if (asJson)
+        json(deps, view);
+    else {
+        if (Object.keys(update).length > 0)
+            deps.out('Cloud budget updated.');
+        printBudget(view, deps.out);
+        const seat = deps.seat();
+        if (!seat.ready)
+            deps.out(`Seat ${seat.id}: not ready — ${seat.reason ?? 'unknown reason'}`);
+    }
+    return 0;
+}
+function cmdBacklog(deps, args) {
+    const asJson = takeFlag(args, '--json');
+    rejectLeftovers(args);
+    const view = deps.backlog(deps.listTasks(), deps.now());
+    if (asJson) {
+        json(deps, view);
+        return 0;
+    }
+    const c = makeColors(deps.color);
+    if (view.items.length === 0) {
+        deps.out('The self-improvement backlog is empty.');
+        return 0;
+    }
+    deps.out(`Self-improvement backlog · next up: ${view.nextUp ?? 'nothing available'}`);
+    for (const item of view.items) {
+        const status = item.claimedBy
+            ? c.dim(` (${item.lastState ? STATE_LABEL[item.lastState] : 'claimed'} · ${item.claimedBy})`)
+            : '';
+        const marker = item.id === view.nextUp ? c.green('→') : ' ';
+        deps.out(`${marker} P${item.priority}  ${item.title}${status}`);
+        deps.out(`       ${c.dim(`${item.id} · ${item.area}${item.repo ? ` · ${item.repo}` : ''}`)}`);
+    }
+    return 0;
+}
+// ---------------------------------------------------------------------------
+// Entry point
+// ---------------------------------------------------------------------------
+export async function runCloudCli(argv, injected) {
+    const args = [...argv];
+    const sub = args.shift();
+    const print = injected?.out ?? ((line) => console.log(line));
+    const printErr = injected?.err ?? ((line) => console.error(line));
+    if (!sub || sub === 'help' || sub === '--help' || sub === '-h') {
+        (sub ? print : printErr)(USAGE);
+        return sub ? 0 : 2;
+    }
+    const known = ['launch', 'list', 'ls', 'refresh', 'improve', 'budget', 'backlog'];
+    if (!known.includes(sub)) {
+        printErr(`Unknown cloud command "${sub}".\n\n${USAGE}`);
+        return 2;
+    }
+    // Only a known verb pays for loading the cloud core.
+    const deps = injected && isComplete(injected) ? injected : { ...(await defaultDeps()), ...injected };
+    try {
+        switch (sub) {
+            case 'launch': return await cmdLaunch(deps, args);
+            case 'list':
+            case 'ls': return cmdList(deps, args);
+            case 'refresh': return await cmdRefresh(deps, args);
+            case 'improve': return await cmdImprove(deps, args);
+            case 'budget': return cmdBudget(deps, args);
+            default: return cmdBacklog(deps, args);
+        }
+    }
+    catch (err) {
+        if (err instanceof UsageError) {
+            deps.err(`${err.message}\n\n${USAGE}`);
+            return 2;
+        }
+        deps.err(`cloud ${sub} failed: ${withoutHome(err instanceof Error ? err.message : String(err))}`);
+        return 1;
+    }
+}
+/** No absolute home paths in output: an error from the checkout or store can quote one. */
+function withoutHome(text) {
+    const home = process.env['HOME'];
+    return home && home.length > 1 ? text.split(home).join('~') : text;
+}
+const DEP_KEYS = [
+    'launch', 'listTasks', 'readBudget', 'updateBudget', 'budgetView', 'refresh', 'improve', 'backlog',
+    'seat', 'originRepo', 'cwd', 'now', 'out', 'err', 'color',
+];
+function isComplete(deps) {
+    return DEP_KEYS.every((key) => deps[key] !== undefined);
+}
+//# sourceMappingURL=cloud.js.map