@farmslot/recipe-cli 0.8.0 → 0.9.0

package/dist/harness/stage-progress.js

@@ -0,0 +1,162 @@
+// stage-progress — the one renderer for setup stages (launch, prepare, doctor
+// --fix). Each stage is a line on stderr, `[2/5] metro: bundling 61% (4,210/6,900
+// modules), 1m42s`, repeated at least every 15 s while it runs, so a slow start
+// and a hang read differently. A payload that stops changing gets a plain "no
+// progress for 1m00s" line; it never fails the command. Stdout and every --json
+// document stay as they were; --json-stream gets a `stage` event per line.
+const HEARTBEAT_MS = 15_000;
+const STALL_NOTICE_MS = 60_000;
+/** A line from a child harness command that is itself a stage line. */
+export const STAGE_LINE = /^\[\d+\/\d+\] /u;
+/** `20s`, `1m42s`, `1h03m`. */
+export function formatElapsed(ms) {
+    const seconds = Math.max(0, Math.floor(ms / 1000));
+    if (seconds < 60)
+        return `${seconds}s`;
+    const minutes = Math.floor(seconds / 60);
+    if (minutes < 60)
+        return `${minutes}m${String(seconds % 60).padStart(2, '0')}s`;
+    return `${Math.floor(minutes / 60)}h${String(minutes % 60).padStart(2, '0')}m`;
+}
+// The payload as the event carries it; also what "changed" compares, so a
+// percent moving within one whole number is not progress the line could show.
+function progressFields(progress) {
+    const fields = {
+        waitingFor: progress.waitingFor,
+        message: progress.message,
+        percent: progress.percent === undefined ? undefined : Math.floor(progress.percent),
+        current: progress.current,
+        totalCount: progress.total,
+        unit: progress.unit,
+        screen: progress.screen,
+    };
+    return Object.fromEntries(Object.entries(fields).filter((entry) => entry[1] !== undefined));
+}
+const count = (value) => value.toLocaleString('en-US');
+/** `bundling 61% (4,210/6,900 modules)`, `waiting for unlock, page is #onboarding/welcome`. */
+export function stageProgressText(progress) {
+    const { message, waitingFor, percent, current, total, unit, screen } = progress;
+    const counts = current === undefined
+        ? undefined
+        : `(${count(current)}${total === undefined ? '' : `/${count(total)}`}${unit ? ` ${unit}` : ''})`;
+    const head = [message, waitingFor && `waiting for ${waitingFor}`].filter(Boolean).join(', ');
+    const measured = [head, percent === undefined ? undefined : `${Math.floor(percent)}%`, counts]
+        .filter(Boolean)
+        .join(' ');
+    return [measured, screen && `page is ${screen}`].filter(Boolean).join(', ');
+}
+function stallNoticeMs() {
+    const value = Number(process.env.RECIPE_STAGE_STALL_NOTICE_MS);
+    return Number.isFinite(value) && value > 0 ? value : STALL_NOTICE_MS;
+}
+export function createStageReporter(options = {}) {
+    const write = options.write ?? ((line) => process.stderr.write(`${line}\n`));
+    const heartbeatMs = options.heartbeatMs ?? HEARTBEAT_MS;
+    const stallMs = options.stallMs ?? stallNoticeMs();
+    const open = new Set();
+    // A plain heartbeat is owed when the command has been quiet, not each stage:
+    // a stage that speaks for the whole command keeps another one quiet. A stall
+    // notice is always said.
+    let lastLineAt = 0;
+    // When any stage last moved: an outer stage with no progress of its own
+    // (`launch` around an adapter's stages) moves when the command does.
+    let lastChangeAt = 0;
+    return {
+        stage(name, { index, total }) {
+            const prefix = `[${index}/${total}] ${name}`;
+            const startedAt = Date.now();
+            lastChangeAt = startedAt;
+            let latest = {};
+            let latestKey = '{}';
+            let changedAt = startedAt;
+            let timer;
+            let ended = false;
+            const line = (text, status, fields = {}) => {
+                const elapsedMs = Date.now() - startedAt;
+                lastLineAt = Date.now();
+                write(`${prefix}: ${text}, ${formatElapsed(elapsedMs)}`);
+                options.event?.({ stage: name, index, total, status, elapsedMs, ...fields });
+            };
+            const heartbeat = () => {
+                const now = Date.now();
+                const movedAt = latestKey === '{}' ? Math.max(changedAt, lastChangeAt) : changedAt;
+                const stalledMs = now - movedAt;
+                const quietMs = now - lastLineAt;
+                if (stalledMs < stallMs && quietMs < heartbeatMs) {
+                    schedule(heartbeatMs - quietMs);
+                    return;
+                }
+                const text = stageProgressText(latest);
+                if (stalledMs >= stallMs) {
+                    const still = latest.screen ? `still on ${latest.screen}` : text && `still ${text}`;
+                    const notice = [`no progress for ${formatElapsed(stalledMs)}`, still].filter(Boolean);
+                    line(notice.join(', '), 'progress', { ...progressFields(latest), stalledMs });
+                }
+                else {
+                    line(text || 'running', 'progress', progressFields(latest));
+                }
+                schedule(heartbeatMs);
+            };
+            // Unref'd: feedback must never be what keeps the process alive.
+            const schedule = (delayMs) => {
+                clearTimeout(timer);
+                timer = setTimeout(heartbeat, delayMs);
+                timer.unref();
+            };
+            const end = (status, detail) => {
+                if (ended)
+                    return;
+                ended = true;
+                clearTimeout(timer);
+                open.delete(handle);
+                line(detail ? `${status}, ${detail}` : status, status, detail ? { message: detail } : {});
+            };
+            const handle = {
+                progress(progress) {
+                    if (ended)
+                        return;
+                    const fields = progressFields(progress);
+                    const key = JSON.stringify(fields);
+                    // The same payload again is not progress; the heartbeat repeats it.
+                    if (key === latestKey)
+                        return;
+                    latest = { ...progress };
+                    latestKey = key;
+                    changedAt = Date.now();
+                    lastChangeAt = changedAt;
+                    line(stageProgressText(latest) || 'running', 'progress', fields);
+                    schedule(heartbeatMs);
+                },
+                done: (detail) => end('done', detail),
+                failed: (detail) => end('failed', detail),
+                forward(childLine) {
+                    if (ended)
+                        return;
+                    lastLineAt = Date.now();
+                    write(`${prefix} › ${childLine}`);
+                    if (!childLine.includes('no progress for')) {
+                        changedAt = Date.now();
+                        lastChangeAt = changedAt;
+                    }
+                    // A child line counts as this stage's line: the parent speaks only
+                    // when the child has been quiet for a heartbeat.
+                    schedule(heartbeatMs);
+                },
+            };
+            open.add(handle);
+            line('started', 'start');
+            schedule(heartbeatMs);
+            return handle;
+        },
+        close(status, detail) {
+            // Innermost first: a stage opened inside another ends before it.
+            for (const stage of [...open].reverse()) {
+                if (status === 'done')
+                    stage.done(detail);
+                else
+                    stage.failed(detail);
+            }
+        },
+    };
+}
+//# sourceMappingURL=stage-progress.js.map

package/dist/harness/stage-progress.js.map

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

package/dist/harness/task-view.d.ts

@@ -0,0 +1,142 @@
+import { type TaskOperation } from '@farmslot/protocol';
+import { type AcceptanceCriterionView } from '@farmslot/protocol/contracts/acceptance';
+export declare const CHECKLIST_LABEL_LIMIT = 70;
+export interface TaskViewCheckout {
+    target: string;
+    branch?: string;
+    head?: string;
+}
+export interface TaskViewIsolation {
+    slotId?: string;
+    platform?: string;
+    metroPort?: number;
+    watcherPort?: number;
+    devServerPort?: number;
+    simulator?: string;
+    simulatorUdid?: string;
+    cdpPort?: number;
+    extensionId?: string;
+}
+export interface TaskViewHarness {
+    version?: string;
+    sourceKind?: string;
+}
+export interface TaskViewTemplate {
+    id?: string;
+    sourceId?: string;
+    flow?: string;
+    domain?: string;
+    surface?: string;
+    title?: string;
+    ticket?: string;
+}
+export interface TaskViewLibrary {
+    name?: string;
+    path: string;
+}
+export interface TaskViewFixture {
+    fixture?: string;
+    canonicalFixture?: string;
+    status?: string;
+    walletReset?: boolean;
+}
+export interface TaskViewSandbox {
+    ready?: boolean;
+}
+export interface TaskViewRow {
+    /** The second-level heading this row sits under in CHECKLIST.md, when there is one. */
+    phase?: string;
+    number: number;
+    label: string;
+    checked: boolean;
+    /** Time from the previous marked row (or the handoff start) to this mark. */
+    durationMs?: number;
+    /** Time since the last mark, on the row the agent is working now. */
+    runningMs?: number;
+}
+/** Where a child unit's markdown came from, as `mark` recorded it. */
+export interface TaskViewSubtaskSource {
+    kind?: string;
+    ref?: string;
+}
+/**
+ * A child checklist unit registered on one parent row (ADR-060). Its rows are
+ * enumerated by the same protocol parser as the parent checklist, so a row here
+ * is the box `mark sub <id> <n>` ticks.
+ */
+export interface TaskViewSubtask {
+    id: string;
+    /** 1-based parent row this unit owns. */
+    parentStep: number;
+    status?: string;
+    /** False while the unit still owns its parent row (`running` or `blocked`). */
+    settled: boolean;
+    rows: TaskViewRow[];
+    source?: TaskViewSubtaskSource;
+}
+export interface TaskViewSignal {
+    status?: string;
+    step?: string;
+    timestamp?: string;
+    attemptId?: string;
+}
+export interface TaskView {
+    operations: Array<TaskOperation & {
+        ownerAlive: boolean;
+    }>;
+    checkout: TaskViewCheckout;
+    taskDir?: string;
+    isolation?: TaskViewIsolation;
+    harness?: TaskViewHarness;
+    template?: TaskViewTemplate;
+    acceptance?: AcceptanceCriterionView[];
+    libraries: TaskViewLibrary[];
+    fixture?: TaskViewFixture;
+    sandbox?: TaskViewSandbox;
+    prepare?: TaskViewPrepare;
+    checklist: TaskViewRow[];
+    /** Child units registered on this task's rows, in registration order. */
+    subtasks: TaskViewSubtask[];
+    signal?: TaskViewSignal;
+    /** The last journaled harness command run in this checkout (call, run, launch, …). */
+    lastCommand?: TaskViewCommand;
+    currentStep?: number;
+    elapsedMs?: number;
+    activity: TaskViewActivity;
+}
+export interface TaskViewPrepare {
+    step: string;
+    elapsedMs: number;
+    completed: number;
+    total: number;
+    steps: Array<{
+        id: string;
+        status: string;
+        durationMs: number;
+    }>;
+    startedAt: string;
+    updatedAt: string;
+}
+export interface TaskViewCommand {
+    command: string;
+    /** The first positional argument, e.g. the action of `call` or the recipe of `run`. */
+    subject?: string;
+    verdict?: string;
+    /** When the command finished, or started when it is still running. */
+    at?: string;
+    /** Time since `at`. */
+    ageMs?: number;
+}
+/** Whether a task is in progress in this checkout, and why not when it is not. */
+export interface TaskViewActivity {
+    ongoing: boolean;
+    reason?: 'no-task' | 'finished' | 'silent';
+    /** Time since the task last wrote its signal, ticked a row, or ran a harness command. */
+    idleMs?: number;
+    /** False when the task names a ticket and the checked-out branch does not carry it. */
+    branchCarriesTicket?: boolean;
+}
+export declare const TASK_SILENT_AFTER_MS: number;
+export declare function findTaskDir(target: string): string | undefined;
+export declare function collectTaskView(target: string, taskDir: string | undefined, now: number): TaskView;
+//# sourceMappingURL=task-view.d.ts.map

package/dist/harness/task-view.d.ts.map

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