cloving 1.3.0 → 1.4.0

package/dist/src/cli/report.js

@@ -1,6 +1,8 @@
+import { textReport } from "./report-text.js";
 import { record } from "../protocol.js";
 import { loopReport, } from "../report.js";
 import { send } from "./client.js";
+import { readReportFlow } from "./report-flow.js";
 import { readReportGithub } from "./report-github.js";
 function reportRecord(value, after) {
     const event = record(value) ?? {};
@@ -22,6 +24,10 @@ function appendEvents(snapshot, values) {
         snapshot.after = parsed.sequence;
         if (snapshot.observedSince === null || parsed.at < snapshot.observedSince)
             snapshot.observedSince = parsed.at;
+        if (["effect.requested", "effect.reported"].includes(String(parsed.event["type"])))
+            snapshot.effects.push({ ...parsed.event, at: parsed.at });
+        if (["run.started", "schedule.skipped"].includes(String(parsed.event["type"])))
+            snapshot.flowEvents.push(parsed.event);
         const completion = reportCompletion(parsed.event);
         if (completion === null)
             continue;
@@ -36,6 +42,8 @@ async function daemonReport(runtime) {
         latest: null,
         observedSince: null,
         completions: new Map(),
+        effects: [],
+        flowEvents: [],
     };
     for (;;) {
         const reply = await send(runtime, {
@@ -57,6 +65,8 @@ async function daemonReport(runtime) {
         if (snapshot.after >= snapshot.latest)
             return {
                 completions: [...snapshot.completions.values()],
+                effects: snapshot.effects,
+                flowEvents: snapshot.flowEvents,
                 observedSince: snapshot.observedSince,
             };
         if (events.length < 1000)
@@ -78,11 +88,12 @@ async function runCost(runtime, runId) {
     if (reply.kind === "error")
         return { runId, turns: null };
     const run = record(reply.result["run"]);
-    const turns = run?.["workerTurns"];
-    if (run?.["runId"] !== runId ||
-        !Array.isArray(turns) ||
-        !settledSpending(run))
+    if (run?.["runId"] !== runId)
         return { runId, turns: null };
+    const turns = run["workerTurns"];
+    const ticket = runTicket(run);
+    if (!Array.isArray(turns) || !settledSpending(run))
+        return { runId, ...ticket, turns: null };
     const parsed = turns.map((value) => {
         const turn = record(value);
         const operationId = turn?.["operationId"];
@@ -97,29 +108,14 @@ async function runCost(runtime, runId) {
     });
     return {
         runId,
+        ...ticket,
         turns: parsed.some((turn) => turn === null)
             ? null
             : parsed.filter((turn) => turn !== null),
     };
 }
-function textReport(report) {
-    const lines = [`Loop report ${JSON.stringify(report["window"])}`];
-    for (const [name, value] of Object.entries(record(report["metrics"]) ?? {})) {
-        const metric = record(value) ?? {};
-        lines.push(`${name}: ${metric["status"] === "unavailable" ? "unavailable" : String(metric["value"])}`);
-        const baseline = record(metric["baseline"]) ?? {};
-        lines.push(`  history: ${String(baseline["history"])}; median: ${String(baseline["median"])}; band: ${JSON.stringify(baseline["band"])}${metric["mark"] === "outside" ? "; outside" : ""}`);
-        lines.push(`  comparison value: ${String(metric["comparisonValue"])}`);
-        lines.push(`  evidence: ${JSON.stringify(metric["evidence"])}`);
-        lines.push(`  baseline evidence: ${JSON.stringify(baseline["evidence"])}`);
-    }
-    lines.push(`Run costs (USD): ${JSON.stringify(report["runCosts"])}`);
-    lines.push(`Sources: ${JSON.stringify(report["sources"])}`);
-    lines.push(`Coverage: ${JSON.stringify(report["coverage"])}`);
-    return lines.join("\n") + "\n";
-}
 export async function reportCommand(invocation, environment) {
-    const now = Date.now();
+    const now = environment.now ?? Date.now();
     const since = new Date(now - (invocation.since + 168) * 3_600_000).toISOString();
     const settings = environment.watchPr === undefined ? {} : { settings: environment.watchPr };
     const [daemonRead, githubRead] = await Promise.allSettled([
@@ -128,14 +124,25 @@ export async function reportCommand(invocation, environment) {
     ]);
     const daemon = daemonRead.status === "fulfilled"
         ? daemonRead.value
-        : { completions: null, observedSince: null };
+        : {
+            completions: null,
+            effects: null,
+            flowEvents: null,
+            observedSince: null,
+        };
     const github = githubRead.status === "fulfilled" ? { github: githubRead.value } : {};
-    const costs = [];
-    for (const event of daemon.completions ?? [])
-        if (event.at >= now - (invocation.since + 168) * 3_600_000 &&
-            event.at < now)
-            costs.push(await runCost(environment.runtimeDirectory, event.runId));
+    const costs = await reportCosts(environment.runtimeDirectory, {
+        completions: daemon.completions ?? [],
+        start: Date.parse(since),
+        end: now,
+        issues: githubRead.status === "fulfilled" ? githubRead.value.issues : null,
+    });
     const calculated = loopReport({
+        flow: await readReportFlow(environment.runtimeDirectory, {
+            events: daemon.flowEvents,
+            start: Date.parse(since),
+            completions: daemon.completions,
+        }),
         since: invocation.since,
         now,
         ...daemon,
@@ -190,3 +197,73 @@ export function reportCompletion(event) {
         throw new Error("invalid-report-event");
     return { runId, sequence, at: Date.parse(at), outcome };
 }
+function runTicket(run) {
+    const ticketId = run?.["ticketId"];
+    return ticketId === null || (typeof ticketId === "string" && ticketId !== "")
+        ? { ticketId }
+        : {};
+}
+async function ticketIndex(runtime) {
+    const index = new Map();
+    let after = "";
+    for (;;) {
+        const reply = await send(runtime, {
+            operation: "status",
+            parameters: { metadata: "tickets", after, limit: 500 },
+        });
+        if (reply.kind === "error")
+            throw new Error(reply.error.code);
+        const runs = reply.result["runs"];
+        if (!Array.isArray(runs))
+            throw new Error("invalid-report-ticket-index");
+        const latest = appendTicketIndex(index, { runs, after });
+        const next = reply.result["next"];
+        if (next === null)
+            return index;
+        if (typeof next !== "string" || next !== latest || next <= after)
+            throw new Error("invalid-report-ticket-cursor");
+        after = next;
+    }
+}
+async function reportCosts(runtime, input) {
+    const ended = input.completions.filter((event) => event.at < input.end);
+    const costs = [];
+    for (const event of ended.filter((event) => event.at >= input.start))
+        costs.push(await runCost(runtime, event.runId));
+    const older = ended.filter((event) => event.at < input.start);
+    const tickets = new Set((input.issues ?? [])
+        .filter((issue) => issue.at >= input.start && issue.at < input.end)
+        .map((issue) => String(issue.evidence["issue"])));
+    if (older.length === 0 || tickets.size === 0)
+        return costs;
+    try {
+        const index = await ticketIndex(runtime);
+        for (const event of older) {
+            const ticketId = index.get(event.runId);
+            if (ticketId === undefined)
+                continue;
+            costs.push(ticketId !== null && tickets.has(ticketId)
+                ? await runCost(runtime, event.runId)
+                : { runId: event.runId, ticketId, turns: null });
+        }
+    }
+    catch {
+        return costs;
+    }
+    return costs;
+}
+function appendTicketIndex(index, page) {
+    let latest = page.after;
+    for (const value of page.runs) {
+        const row = record(value);
+        const runId = row?.["runId"];
+        const ticketId = row?.["ticketId"];
+        if (typeof runId !== "string" ||
+            runId <= latest ||
+            !(ticketId === null || (typeof ticketId === "string" && ticketId !== "")))
+            throw new Error("invalid-report-ticket-index");
+        index.set(runId, ticketId);
+        latest = runId;
+    }
+    return latest;
+}

package/dist/src/cli/runtime-arguments.d.ts

@@ -1,3 +1,4 @@
+import { type ScheduleInvocation } from "./schedule-arguments.ts";
 export type RunSource = {
     readonly kind: "prompt";
     readonly text: string;
@@ -10,7 +11,7 @@ export type RunSource = {
 };
 type DecisionCommand = "answer" | "approve" | "deny";
 type RunCommand = "pause" | "resume" | "drop";
-export type RuntimeInvocation = {
+export type RuntimeInvocation = ScheduleInvocation | {
     readonly kind: "report";
     readonly since: number;
     readonly json: boolean;

package/dist/src/cli/runtime-arguments.js

@@ -1,4 +1,5 @@
 import { isRecordKey } from "../authority/commands.js";
+import { scheduleInvocation, } from "./schedule-arguments.js";
 const identifier = /^[A-Za-z0-9._:/-]{1,128}$/;
 const decisionReference = /^[A-Za-z0-9._:/-]{1,256}$/;
 const sha256Digest = /^sha256:[0-9a-f]{64}$/;
@@ -71,17 +72,21 @@ const shapes = new Map([
     ],
 ]);
 export function isRuntimeCommand(command) {
-    return shapes.has(command);
+    return command === "schedule" || shapes.has(command);
 }
 export function runtimeInvocation(request) {
     const shape = shapes.get(request.command);
-    if (shape === undefined)
+    if (!isRuntimeCommand(request.command))
         return "unknown-command";
     const names = request.options.map((option) => option.name);
     if (new Set(names).size !== names.length)
         return "repeated-option";
     if (names.includes("help"))
         return { kind: "command-help", command: request.command };
+    if (request.command === "schedule")
+        return scheduleInvocation(request);
+    if (shape === undefined)
+        return "unknown-command";
     return shapeFailure(shape, request) ?? shape.build(request);
 }
 function shapeFailure(shape, request) {

package/dist/src/cli/schedule-arguments.d.ts

@@ -0,0 +1,14 @@
+import type { ServiceRequest } from "../protocol.ts";
+export interface ScheduleInvocation {
+    readonly kind: "schedule";
+    readonly action: "list" | "pause" | "resume";
+    readonly workflowId: string | null;
+    readonly json: boolean;
+}
+export declare function scheduleInvocation(request: {
+    readonly positionals: readonly string[];
+    readonly options: readonly {
+        readonly name: string;
+    }[];
+}): ScheduleInvocation | string;
+export declare function scheduleServiceRequest(invocation: ScheduleInvocation): ServiceRequest;

package/dist/src/cli/schedule-arguments.js

@@ -0,0 +1,26 @@
+import { isRecordKey } from "../authority/commands.js";
+export function scheduleInvocation(request) {
+    if (request.options.some((option) => option.name !== "json"))
+        return "unexpected-option";
+    const [action, workflowId] = request.positionals;
+    const json = request.options.some((option) => option.name === "json");
+    if (action === undefined)
+        return { kind: "schedule", action: "list", workflowId: null, json };
+    if (action !== "pause" && action !== "resume")
+        return "invalid-schedule-action";
+    if (workflowId === undefined)
+        return "missing-argument";
+    if (request.positionals.length > 2)
+        return "unexpected-argument";
+    if (!isRecordKey(workflowId))
+        return "invalid-option-value";
+    return { kind: "schedule", action, workflowId, json };
+}
+export function scheduleServiceRequest(invocation) {
+    return {
+        operation: "schedule",
+        parameters: invocation.workflowId === null
+            ? { action: invocation.action }
+            : { action: invocation.action, workflowId: invocation.workflowId },
+    };
+}

package/dist/src/cli/schedule-render.d.ts

@@ -0,0 +1,22 @@
+import { type Fields } from "../protocol.ts";
+export declare function scheduleLines(result: Fields): readonly string[];
+export interface ShownSchedule {
+    readonly workflowId: string;
+    readonly everySeconds: number;
+    readonly state: "active" | "paused" | "stopped";
+    readonly failuresInRow: number;
+    readonly nextAt: number | null;
+    readonly stoppedAt: number | null;
+}
+export declare function scheduleStatusLine(schedule: ShownSchedule, style?: "status" | "watch"): string;
+export type ShownSchedules = readonly ShownSchedule[] | {
+    readonly status: "unavailable";
+};
+export declare function shownSchedules(value: unknown): ShownSchedules;
+export declare function statusScheduleLines(value: unknown): readonly string[];
+export declare function shownScheduled(value: unknown): {
+    readonly scheduled?: {
+        readonly slot: number;
+    };
+};
+export declare function scheduledText(value: unknown): string;

package/dist/src/cli/schedule-render.js

@@ -0,0 +1,73 @@
+import { record } from "../protocol.js";
+function line(value) {
+    const schedule = record(value) ?? {};
+    const nextAt = schedule["nextAt"];
+    const runId = schedule["activeRunId"];
+    const activeRun = typeof runId === "string" ? runId : "none";
+    const next = typeof nextAt === "number" ? new Date(nextAt).toISOString() : "none";
+    return `  ${String(schedule["workflowId"])}  every ${String(schedule["everySeconds"])} seconds  ${String(schedule["state"])}  next ${next}  ${String(schedule["failuresInRow"])} failures in a row  slot ${String(schedule["lastSlot"])}  active run ${activeRun}`;
+}
+export function scheduleLines(result) {
+    if (result["kind"] === "schedule")
+        return [line(result["schedule"])];
+    const schedules = result["schedules"];
+    const lines = Array.isArray(schedules) ? schedules.map(line) : [];
+    return ["Schedules:", ...(lines.length === 0 ? ["  none"] : lines)];
+}
+export function scheduleStatusLine(schedule, style = "status") {
+    const time = (at) => style === "watch"
+        ? new Date(at).toLocaleString()
+        : new Date(at).toISOString();
+    const next = schedule.state === "active" && schedule.nextAt !== null
+        ? `, next run at ${time(schedule.nextAt)}`
+        : "";
+    const stopped = schedule.state === "stopped" && schedule.stoppedAt !== null
+        ? `, stopped at ${time(schedule.stoppedAt)}`
+        : "";
+    return `Schedule ${schedule.workflowId}: every ${String(schedule.everySeconds)} s, ${schedule.state}${next}${stopped}, ${String(schedule.failuresInRow)} failures in a row`;
+}
+export function shownSchedules(value) {
+    if (record(value)?.["status"] === "unavailable")
+        return { status: "unavailable" };
+    if (!Array.isArray(value))
+        return [];
+    return value.flatMap((entry) => {
+        const schedule = record(entry);
+        if (typeof schedule?.["workflowId"] !== "string" ||
+            typeof schedule["everySeconds"] !== "number" ||
+            typeof schedule["failuresInRow"] !== "number")
+            return [];
+        const state = schedule["state"];
+        if (state !== "active" && state !== "paused" && state !== "stopped")
+            return [];
+        const stamp = (value) => typeof value === "number" && Number.isFinite(new Date(value).getTime())
+            ? value
+            : null;
+        return [
+            {
+                workflowId: schedule["workflowId"],
+                everySeconds: schedule["everySeconds"],
+                state,
+                failuresInRow: schedule["failuresInRow"],
+                nextAt: stamp(schedule["nextAt"]),
+                stoppedAt: stamp(schedule["stoppedAt"]),
+            },
+        ];
+    });
+}
+export function statusScheduleLines(value) {
+    const schedules = shownSchedules(value);
+    return "status" in schedules
+        ? ["Schedules: unavailable"]
+        : schedules.map((schedule) => scheduleStatusLine(schedule));
+}
+export function shownScheduled(value) {
+    const slot = record(value)?.["slot"];
+    return typeof slot === "number" && Number.isSafeInteger(slot) && slot >= 0
+        ? { scheduled: { slot } }
+        : {};
+}
+export function scheduledText(value) {
+    const { scheduled } = shownScheduled(value);
+    return scheduled === undefined ? "" : `scheduled ${String(scheduled.slot)}`;
+}

package/dist/src/cli/terminal-text.d.ts

@@ -0,0 +1,3 @@
+export declare function show(value: unknown): string;
+export declare function oneLine(value: unknown): string;
+export declare function visible(value: unknown): string;

package/dist/src/cli/terminal-text.js

@@ -0,0 +1,28 @@
+export function show(value) {
+    return typeof value === "string" ? value : JSON.stringify(value);
+}
+function escaped(character) {
+    return `\\u${character.charCodeAt(0).toString(16).padStart(4, "0")}`;
+}
+const hiddenRanges = [
+    [0x00, 0x1f],
+    [0x7f, 0x9f],
+    [0x061c, 0x061c],
+    [0x200b, 0x200f],
+    [0x2028, 0x202e],
+    [0x2060, 0x2069],
+    [0xfeff, 0xfeff],
+];
+function hidden(character) {
+    const code = character.charCodeAt(0);
+    return hiddenRanges.some(([first, last]) => code >= first && code <= last);
+}
+export function oneLine(value) {
+    return Array.from(show(value), (character) => hidden(character) ? escaped(character) : character).join("");
+}
+export function visible(value) {
+    return show(value)
+        .split("\n")
+        .map((line) => Array.from(line, (character) => hidden(character) ? escaped(character) : character).join(""))
+        .join("\n    ");
+}

package/dist/src/cli/usage-render.d.ts

@@ -6,3 +6,4 @@ export declare function statusJson(result: Fields): Fields;
 import { type Fields } from "../protocol.ts";
 export declare function attemptText(attempt: WorkerAttemptUsage): string;
 export declare function attemptTexts(value: unknown): readonly string[];
+export declare function queueSpendLines(value: unknown): readonly string[];

package/dist/src/cli/usage-render.js

@@ -60,8 +60,35 @@ export function attemptText(attempt) {
     const kind = attempt.retryKind === undefined
         ? ""
         : ` · retryKind: ${String(attempt.retryKind)}`;
-    return `Attempt ${String(attempt.attempt)} · ${attempt.model ?? "Model not known"}${kind} · ${priceText(attempt.costUsd, attempt.estimatedCostUsd)}`;
+    const resumed = attempt.resumedAfter === undefined
+        ? ""
+        : ` · resumedAfter: ${attempt.resumedAfter}`;
+    return `Attempt ${String(attempt.attempt)} · ${attempt.model ?? "Model not known"}${kind}${resumed} · ${priceText(attempt.costUsd, attempt.estimatedCostUsd)}`;
 }
 export function attemptTexts(value) {
     return (attemptsOf(value) ?? []).map(attemptText);
 }
+export function queueSpendLines(value) {
+    const spend = record(value);
+    if (spend === undefined)
+        return [];
+    const spent = priceOf(spend["spentUsd"]);
+    const limit = priceOf(spend["limitUsd"]);
+    const unknown = Number(spend["unknownTurns"]);
+    const working = Number(spend["turnsInWork"]);
+    return [
+        `Spend: ${priceText(spent).replace(/ USD$/, "")} of ${priceText(limit)} in the last 24 hours`,
+        ...(unknown > 0
+            ? [`${String(unknown)} turn${unknown === 1 ? "" : "s"} with unknown cost`]
+            : []),
+        ...(working > 0
+            ? [`${String(working)} turn${working === 1 ? "" : "s"} in work`]
+            : []),
+        ...(spend["holding"] === true
+            ? ["Queue holds new runs for spend limit"]
+            : []),
+        ...(spent !== null && limit !== null && spent > limit
+            ? ["Spend is over the limit"]
+            : []),
+    ];
+}

package/dist/src/cli/usage.d.ts

@@ -1,5 +1,5 @@
 export declare const configUsage = "Usage: cloving config list [--json]\n       cloving config get <field> [--json]\n       cloving config set <field> <value> [--private] [--json]\n       cloving config unset <field> [--private] [--json]\n\nReads and changes settings for the current repository; --repository selects another repository.\nValues use JSON when valid, otherwise text. Every change is checked before writing.\nFields use their default project or private file; --private selects the private file.\nlist and get show the effective source and hidden file values. Unconfigured values use defaults; null means no value.\nChanges keep the previous file as .bak and replace the file atomically under a lock.\nA live lock waits at most ten seconds, then exits with settings-locked.\nPrivate files, backups and temporary files have mode 0600. Changes require a service restart.\n";
 export declare const commandUsage: Readonly<Record<string, string>>;
-export declare const usage = "Usage: cloving [--help] [--version]\n       cloving workflows list [--json] [--repository <directory>]\n       cloving workflows test [<id>] [--repository <directory>]\n       cloving workflows validate <manifest-path> [--input <json-file>] [--json]\n       cloving templates list [--json]\n       cloving templates show <name> [--json]\n       cloving templates copy <name> [--id <workflow-id>] [--json] [--repository <directory>]\n       cloving <command> [--help]\n\nCommands:\n  workflows list      List bundled, project and user workflows and refusal codes.\n  workflows test      Run project and user workflow tests without a service.\n  workflows validate  Check a compiled workflow manifest, its artifacts and optional runtime input.\n  templates list      List the workflow templates of the package.\n  templates show      Show the decision points and the files of one template.\n  templates copy      Copy one template into .cloving/workflows of the repository.\n  doctor     Check repository requirements before starting or submitting work.\n  run        Submit one run of an admitted workflow.\n  status     List the runs or show one run.\n  report     Report loop facts and seven-day baselines.\n  questions  List the pending decisions.\n  answer     Answer one design question.\n  approve    Approve one pending approval.\n  deny       Deny one pending approval.\n  pause      Stop new dispatch for a run.\n  resume     Resume a paused run.\n  drop       Cancel a run and keep its files.\n  events     Print the committed events.\n  watch      Serve a page that shows the runs live.\n  phone      Show, list, remove and reset the connected phones.\n  config     Read and change repository settings.\n  start      Start the service for a repository.\n\nThe runtime commands need a Cloving service. They use the current git repository; --repository <directory> selects another repository. CLOVING_RUNTIME_DIR overrides its runtime directory.\nUse npm exec -- cloving ... for a project-local installation.\n";
+export declare const usage = "Usage: cloving [--help] [--version]\n       cloving workflows list [--json] [--repository <directory>]\n       cloving workflows test [<id>] [--repository <directory>]\n       cloving workflows validate <manifest-path> [--input <json-file>] [--json]\n       cloving init [--harness <name or path>] [--repository <directory>]\n       cloving init-prompt [--repository <directory>]\n       cloving templates list [--json]\n       cloving templates show <name> [--json]\n       cloving templates copy <name> [--id <workflow-id>] [--json] [--repository <directory>]\n       cloving red-green\n       cloving <command> [--help]\n\nCommands:\n  workflows list      List project and user workflows and refusal codes.\n  workflows test      Run project and user workflow tests without a service.\n  workflows validate  Check a compiled workflow manifest, its artifacts and optional runtime input.\n  templates list      List the workflow templates of the package.\n  templates show      Show the decision points and the files of one template.\n  templates copy      Copy one template into .cloving/workflows of the repository.\n  red-green  Check assertion failure on the base and success on the head.\n  init             Start the setup agent\n  init-prompt Print setup instructions for an agent.\n  doctor     Check repository requirements before starting or submitting work.\n  run        Submit one run of an admitted workflow.\n  status     List the runs or show one run.\n  mcp        Serve the read tools over stdio.\n  schedule   List, pause and resume workflow schedules.\n  report     Report loop facts and seven-day baselines.\n  questions  List the pending decisions.\n  answer     Answer one design question.\n  approve    Approve one pending approval.\n  deny       Deny one pending approval.\n  pause      Stop new dispatch for a run.\n  resume     Resume a paused run.\n  drop       Cancel a run and keep its files.\n  events     Print the committed events.\n  watch      Serve a page that shows the runs live.\n  phone      Show, list, remove and reset the connected phones.\n  config     Read and change repository settings.\n  start      Start the service for a repository.\n\nThe runtime commands need a Cloving service. They use the current git repository; --repository <directory> selects another repository. CLOVING_RUNTIME_DIR overrides its runtime directory.\nUse npm exec -- cloving ... for a project-local installation.\n";
 export declare const validateUsage = "Usage: cloving workflows validate <manifest-path> [--input <json-file>] [--json]\n\nChecks a Cloving workflow manifest, its compiled SDK artifacts, declared resources and toolchain, and an optional runtime input file. Relative paths resolve against the current directory.\n\nOptions:\n  --input <json-file>  Validate this runtime input file.\n  --json               Print one versioned JSON result on stdout.\n\nValidation does not admit a run, dispatch effects, import workflow code or call a model.\n\nExample:\n  cloving workflows validate cloving.workflow.json --input input.json\n";
 export declare const phoneUsage = "Usage: cloving phone status [--json]\n       cloving phone list [--json]\n       cloving phone remove <device-id> [--json]\n       cloving phone reset [--json]\n\nShows and changes the phones that answer the questions of this computer.\nstatus shows the registration with cloving.ai and the number of phones.\nlist shows each phone with its device ID, name, platform, state and pairing time.\nremove marks one phone removed on this computer, then asks cloving.ai to remove it. A failure at cloving.ai keeps the phone removed and shows a warning.\nreset removes the registration with cloving.ai, marks all phones removed and deletes phone/link.json and phone/daemon-keys.json.\nConnect a phone with the Connect a phone button of the watch page.\ncloving start runs the phone relay as a child process. With CLOVING_PHONE_RELAY=off, the relay does not start, and status says that the relay is off or not started.\n";

package/dist/src/cli/usage.js

@@ -13,6 +13,30 @@ A live lock waits at most ten seconds, then exits with settings-locked.
 Private files, backups and temporary files have mode 0600. Changes require a service restart.
 `;
 export const commandUsage = {
+    mcp: `Usage: cloving mcp [--repository <directory>]
+
+Serves cloving_status, cloving_questions and cloving_events as read tools over stdio.
+The server binds to one repository at startup. It needs an existing Cloving service.
+Standard output contains only JSON-RPC messages. Diagnostics use standard error.
+`,
+    "red-green": `Usage: cloving red-green
+
+Reads {"head":"<full commit ID>"} on standard input. Uses CLOVING_RED_GREEN to run
+the changed tests on the merge base with origin/HEAD and then on the head.
+Prints one JSON verdict. Verdicts exit with 0; invalid input and git errors exit with 1.
+Uses temporary detached worktrees. CLOVING_COMMAND_SECONDS bounds each prepare or test command.
+`,
+    init: `Usage: cloving init [--harness <name or path>] [--repository <directory>]
+
+Starts the setup agent in the repository with the message "run \`cloving init-prompt\`".
+Choose an installed harness at the terminal, or pass --harness to skip the question.
+A name must have exactly one usable entry; shell:<name> selects a shell function or alias.
+The selection is saved in private settings. The command returns the agent's exit status.
+`,
+    "init-prompt": `Usage: cloving init-prompt [--repository <directory>]
+
+Prints facts, rules and setup steps for an agent. Does not change settings, call a model or control the service.
+`,
     doctor: `Usage: cloving doctor [--json] [--repository <directory>]
 
 Checks repository requirements without repairs, model turns or GitHub writes.
@@ -34,6 +58,15 @@ Success means a committed receipt. It does not mean completed work.
     status: `Usage: cloving status [<run-id>] [--limit <n>] [--after <cursor>] [--json]
 
 Lists the runs, or shows one run with its reason, evidence and next action.
+`,
+    schedule: `Usage: cloving schedule [--json]
+       cloving schedule pause <workflowId> [--json]
+       cloving schedule resume <workflowId> [--json]
+
+Lists interval schedules and their state. Pause stops new runs; an active run continues.
+Three consecutive failed or blocked scheduled runs stop a schedule.
+Resume clears failures and starts the next run one interval later.
+Paused and stopped schedules survive a service restart.
 `,
     questions: `Usage: cloving questions [<run-id>] [--json]
 
@@ -90,10 +123,11 @@ Settings files: .cloving/config.json in the repository and <config>/cloving/proj
 
   CLOVING_RUNTIME_DIR              The path of the runtime directory. The default is ~/.local/state/cloving/<name>-<id>/run, if XDG_RUNTIME_DIR and XDG_STATE_HOME are not set. A recorded legacy adoption takes priority.
   CLOVING_TICKET_COMMAND           A JSON list of a command and its arguments. The command gets a ticket ID as its last argument and prints the ticket. The setting has no default, and a run with --ticket needs it.
-  CLOVING_NOTIFY_COMMAND           A JSON list of a command and its arguments. Every 15 seconds, new decisions, blocked runs and failed runs send JSON on standard input with no added argument. The setting has no default.
+  CLOVING_NOTIFY_COMMAND           A JSON list of a command and its arguments. Every 15 seconds, new decisions, blocked runs, failed runs and stopped schedules send JSON on standard input with no added argument. The setting has no default.
   CLOVING_NEXT_COMMAND             A JSON list of a command and its arguments. The command runs with no added argument and prints one ready ticket ID for --next. It must exclude the space-separated ticket IDs in CLOVING_SKIP_TICKETS. The setting has no default.
-  CLOVING_QUEUE_SECONDS            A whole number from 10 to 3600 seconds between develop-issue queue checks; requires CLOVING_NEXT_COMMAND and CLOVING_TICKET_COMMAND. Unset means no queue. The queue stops after three runs in a row without a successful handoff; manual develop-issue submissions are refused with workflow-active when all lanes are busy.
+  CLOVING_QUEUE_SECONDS            A whole number from 10 to 3600 seconds between checks for a declared workflow with queue: true; requires CLOVING_NEXT_COMMAND and CLOVING_TICKET_COMMAND when that workflow exists. Unset or no queue workflow means no queue. The queue stops after three runs in a row without a successful handoff; manual submissions to that workflow are refused with workflow-active when all lanes are busy.
   CLOVING_QUEUE_LANES              A whole number from 1 to 4; the default is 1. Requires CLOVING_QUEUE_SECONDS. Active tickets are refused with ticket-active. Needs #N sentences in the ticket's ## Dependencies section refuse admission with ticket-dependency-open while issue #N is open.
+  CLOVING_QUEUE_DAILY_SPEND_USD    A positive finite USD number. Requires CLOVING_QUEUE_SECONDS. Holds new queue runs at 85 percent of the limit in the last 24 hours; active runs continue. Unset adds no spend limit.
   CLOVING_WORKFLOW_FOLDER          An absolute folder path; when set, it replaces the user workflow folder. The private setting workflows.folder sets it. The folder itself must not be a symbolic link.
   CLOVING_SCHEDULES                A JSON object mapping declared workflow IDs to {everySeconds, input}; replaces declaration schedules. Intervals are whole seconds from 60 to 86400. Unset keeps declaration schedules. Scheduled runs skip overlapping slots and retain their progress across restart.
   CLOVING_SELF_UPDATE_SECONDS      A whole number from 30 to 3600 seconds between checks of the own checkout; unset means no update. An update stops the daemon and restarts with new code. A change of package-lock.json needs the operator to update and install by hand.
@@ -115,31 +149,40 @@ Settings files: .cloving/config.json in the repository and <config>/cloving/proj
   CLOVING_RELAY_ORIGIN             The origin of the phone relay server. Only https origins are accepted. The default is https://cloving.ai.
   CLOVING_OWNERSHIP_LEASE_SECONDS  The time in seconds of the ownership lease of a started workflow step. The default is 15.
   CLOVING_HOST_BOUND               The largest number of queue messages that the workflow host handles at one time, from 1 to 64. The default is 8.
-  CLOVING_GH_COMMAND               A JSON list of a command and its arguments for the GitHub CLI, which the workflow develop-issue uses for pull requests and develop-prd uses for issues. The watch board also uses it to read pull request status. The default is gh.
-  CLOVING_CHECK_COMMAND            A JSON list of a command and its arguments that the workflow develop-issue runs in the work tree before a merge. A merge does not occur if the command fails. The setting has no default, and with no setting the merge occurs with no check.
-  CLOVING_REQUIRED_CHECKS          A JSON list of required check run names before a develop-issue merge. Unset requires all GitHub Actions checks; a repository with no CI can merge after 60 seconds. The latest run of each name decides. The CI wait limit is 90 minutes.
-  CLOVING_PRIVATE_TEXTS            A JSON list of texts that the workflow develop-issue does not push in a file or in a commit message. The workflow develop-prd requires the list before posting an issue. The list adds to the path of the home folder, and the case of the letters does not matter. The setting has no default.
+  CLOVING_GH_COMMAND               A JSON list of a command and its arguments for the GitHub CLI, used by workflows for pull requests and issues. The watch board also uses it to read pull request status. The default is gh.
+  CLOVING_CHECK_COMMAND            A JSON list of a command and its arguments that a workflow runs in the work tree before a merge. A merge does not occur if the command fails. The setting has no default, and with no setting the merge occurs with no check.
+  CLOVING_RED_GREEN                A JSON object with test and testFiles, optional prepare, assertionPattern and skipPattern for cloving red-green. The project setting is checks.redGreen.
+  CLOVING_REQUIRED_CHECKS          A JSON list of required check run names before a workflow merge. Unset requires all GitHub Actions checks; a repository with no CI can merge after 60 seconds. The latest run of each name decides. The CI wait limit is 90 minutes.
+  CLOVING_PRIVATE_TEXTS            A JSON list of texts that workflows do not push in a file or in a commit message. An issue-posting workflow can require the list. The list adds to the path of the home folder, and the case of the letters does not matter. The setting has no default.
 `,
 };
 export const usage = `Usage: cloving [--help] [--version]
        cloving workflows list [--json] [--repository <directory>]
        cloving workflows test [<id>] [--repository <directory>]
        cloving workflows validate <manifest-path> [--input <json-file>] [--json]
+       cloving init [--harness <name or path>] [--repository <directory>]
+       cloving init-prompt [--repository <directory>]
        cloving templates list [--json]
        cloving templates show <name> [--json]
        cloving templates copy <name> [--id <workflow-id>] [--json] [--repository <directory>]
+       cloving red-green
        cloving <command> [--help]
 
 Commands:
-  workflows list      List bundled, project and user workflows and refusal codes.
+  workflows list      List project and user workflows and refusal codes.
   workflows test      Run project and user workflow tests without a service.
   workflows validate  Check a compiled workflow manifest, its artifacts and optional runtime input.
   templates list      List the workflow templates of the package.
   templates show      Show the decision points and the files of one template.
   templates copy      Copy one template into .cloving/workflows of the repository.
+  red-green  Check assertion failure on the base and success on the head.
+  init             Start the setup agent
+  init-prompt Print setup instructions for an agent.
   doctor     Check repository requirements before starting or submitting work.
   run        Submit one run of an admitted workflow.
   status     List the runs or show one run.
+  mcp        Serve the read tools over stdio.
+  schedule   List, pause and resume workflow schedules.
   report     Report loop facts and seven-day baselines.
   questions  List the pending decisions.
   answer     Answer one design question.

package/dist/src/cli/watch-actions.js

@@ -1,12 +1,12 @@
 import { randomBytes } from "node:crypto";
 import { send } from "./client.js";
 import { watchCardForms } from "./watch-card-forms.js";
-import { join } from "node:path";
+import { dirname, join } from "node:path";
 import { cardRunRequest } from "./watch-run-input.js";
 export async function watchActions(runtimeDirectory) {
     return {
         runtimeDirectory,
-        forms: await watchCardForms(join(import.meta.dirname, "../../workflows")),
+        forms: await watchCardForms(join(dirname(runtimeDirectory), "project")),
         token: randomBytes(32).toString("hex"),
     };
 }