@enderfga/claw-orchestrator 3.4.2 → 3.5.6

package/dist/src/autoloop-types.d.ts

@@ -1,218 +0,0 @@
-/**
- * Types for the autoloop feature.
- *
- * Contracts are documented in tasks/autoloop.md. Schemas here are intentionally
- * narrow — additions belong in the design doc first.
- */
-import type { EngineType } from './types.js';
-export type AutoloopPhase = 'BOOTSTRAP' | 'PROPOSE' | 'EXECUTE' | 'MEASURE' | 'RATCHET' | 'COMPRESS' | 'IDLE' | 'TERMINATED';
-export type AutoloopStatus = 'starting' | 'running' | 'paused' | 'completed' | 'error' | 'stopped';
-export interface ScalarSpec {
-    /** Name of the metric for display / logs */
-    name: string;
-    /** Optimisation direction */
-    direction: 'min' | 'max';
-    /**
-     * Shell command that prints the scalar value to stdout (one number).
-     * Run by EXECUTE in the workspace. Must be deterministic.
-     */
-    extract_cmd: string;
-    /**
-     * Hard wall-clock cap on extract_cmd in seconds. Default 600 (10 min).
-     * For long ML evals (training + measure), set this to your real upper
-     * bound — e.g. 14400 for a 4-hour training run.
-     */
-    extract_timeout_sec?: number;
-    /** Stop when scalar reaches this. For 'min' direction, stop when ≤ target. */
-    target?: number;
-    /** Changes within ±noise_floor are not considered improvements. Default 0. */
-    noise_floor?: number;
-}
-export interface GateSpec {
-    /** Stable identifier (used in state.json gate accounting) */
-    name: string;
-    /**
-     * Shell command. Exit code 0 = pass, non-zero = fail.
-     * Time-limited (see GateSpec.timeout_sec).
-     */
-    cmd: string;
-    /**
-     * Pass condition. Currently only 'exit-0' is supported.
-     * Future: 'stdout-matches:<regex>', 'json-field:<path>=<value>'.
-     */
-    must: 'exit-0';
-    /** Per-gate timeout in seconds. Default 300. */
-    timeout_sec?: number;
-}
-export interface TerminationSpec {
-    scalar_target_hit?: boolean;
-    max_iters: number;
-    /** Plateau triggers async push but loop continues unless user stops. */
-    plateau_iters: number;
-    max_cost_usd: number;
-    /** Cap on un-locked aspirational gates (agent must rotate before adding more). */
-    max_pending_aspirational: number;
-}
-export interface GoalSpec {
-    /**
-     * Optional: when null/absent, the loop has no faithful scalar; goal_completion
-     * becomes the de-facto scalar (= locked_gates_passed / locked_gates_total).
-     */
-    scalar?: ScalarSpec;
-    /** Locked gates (user-approved). Hard requirements; all must pass for ratchet. */
-    gates: GateSpec[];
-    /**
-     * Aspirational gates proposed by agent during BOOTSTRAP or mid-loop.
-     * Don't count toward goal_completion until user moves them to `gates`.
-     * Capped by termination.max_pending_aspirational.
-     */
-    aspirational_gates?: GateSpec[];
-    termination: TerminationSpec;
-}
-export interface BestPoint {
-    iter: number;
-    metric: number;
-    git_sha: string;
-    gate_completion: number;
-}
-export interface MetricPoint {
-    iter: number;
-    metric: number;
-    gate_completion: number;
-}
-export interface StateTree {
-    /** For serial v1: always points to last committed iter. */
-    parent_iter: number | null;
-    /** For population (v2): list of forks. v1 always [iter] or []. */
-    children_iters: number[];
-}
-export type RatchetDecision = 'commit' | 'reset' | 'pending';
-export interface AutoloopState {
-    task_id: string;
-    branch: string;
-    phase: AutoloopPhase;
-    status: AutoloopStatus;
-    iter: number;
-    started_at: string;
-    best: BestPoint | null;
-    last_metric: MetricPoint | null;
-    plateau_count: number;
-    /** Set by RATCHET only. PROPOSE / MEASURE may not write this. */
-    decision: RatchetDecision | null;
-    decision_reason: string | null;
-    /**
-     * Git sha of the BOOTSTRAP commit. Used as the floor for git reset when no
-     * `best` exists yet (otherwise we'd reset to HEAD~1, which after a failed
-     * propose-then-resume can be the wrong target).
-     */
-    bootstrap_sha: string | null;
-    tree: StateTree;
-    termination: {
-        fired: boolean;
-        reason: string | null;
-    };
-    cost_usd_so_far: number;
-    /** Pushed-but-not-yet-locked aspirational gates the agent has proposed. */
-    pending_aspirational_count: number;
-}
-export interface MetricHistoryEntry {
-    iter: number;
-    ts: string;
-    metric: number;
-    gate_completion: number;
-    phase_at_record: AutoloopPhase;
-    git_sha_pre?: string;
-    git_sha_post?: string;
-}
-export interface GateResult {
-    name: string;
-    passed: boolean;
-    exit_code: number;
-    duration_ms: number;
-    /** Truncated stdout/stderr tail for diagnostic context. */
-    output_tail: string;
-}
-export interface EvalOutput {
-    iter: number;
-    ts: string;
-    /** All locked-gate results, in goal.json order. */
-    gates: GateResult[];
-    /** null when no scalar in goal.json or extract_cmd failed. */
-    scalar: number | null;
-    /** Computed = (gates that passed) / (locked gates total). */
-    gate_completion: number;
-    /** True if every locked gate passed. */
-    all_gates_passed: boolean;
-}
-export interface RatchetOutput {
-    iter: number;
-    decision: RatchetDecision;
-    reason: string;
-    /** True if RATCHET wants the runner to push the user (e.g. unsure / new-best / plateau). */
-    push_user?: {
-        kind: 'new_best' | 'plateau' | 'unsure_no_metric' | 'aspirational_proposed';
-        text: string;
-    };
-}
-export type PushKind = 'bootstrap_aspirational' | 'new_best' | 'plateau' | 'unsure_no_metric' | 'aspirational_proposed' | 'termination' | 'hard_error';
-export interface PushEvent {
-    kind: PushKind;
-    text: string;
-    task_id: string;
-    iter: number;
-    ts: string;
-}
-export interface AutoloopConfig {
-    /** Workspace path — must be a git repo. tasks/<id>/ will be created here. */
-    workspace: string;
-    /** Path to plan.md (will be copied into tasks/<id>/plan.md). */
-    plan_path: string;
-    /** Path to goal.json (will be copied + validated into tasks/<id>/goal.json). */
-    goal_path: string;
-    /** Override for the task id; defaults to a timestamped slug. */
-    task_id?: string;
-    /** Engine for PROPOSE/BOOTSTRAP/COMPRESS. Default 'claude'. */
-    propose_engine?: EngineType;
-    /** Model for PROPOSE/BOOTSTRAP/COMPRESS. Default 'opus'. */
-    propose_model?: string;
-    /** Engine for RATCHET. Default 'claude'. */
-    ratchet_engine?: EngineType;
-    /** Model for RATCHET. Default 'opus'. */
-    ratchet_model?: string;
-    /** How often to run COMPRESS. Default 10. */
-    compress_every_k?: number;
-    /** Per-iter wall clock for PROPOSE/EXECUTE phases (ms). Default 600_000 (10 min). */
-    per_iter_timeout_ms?: number;
-    /** Push hook command (defaults to `openclaw message send`). Set to null to disable pushes. */
-    push_cmd?: string | null;
-}
-export interface AutoloopHandle {
-    id: string;
-    status: AutoloopStatus;
-    task_dir: string;
-    started_at: string;
-    ended_at?: string;
-    /** Last-known phase from state.json (cheap to read). */
-    current_phase?: AutoloopPhase;
-    current_iter?: number;
-    best_metric?: number;
-    error?: string;
-}
-export declare class GoalSpecError extends Error {
-    constructor(message: string);
-}
-export declare function validateGoalSpec(raw: unknown): GoalSpec;
-/**
- * Derive the metric value used for ratcheting from an EvalOutput.
- * Rule:
- *   - If goal has a scalar AND eval produced one, use the scalar.
- *   - Otherwise, use gate_completion (∈ [0, 1]).
- */
-export declare function deriveMetric(eval_out: EvalOutput, goal: GoalSpec): number;
-/**
- * Did `candidate` improve over `incumbent` for this goal? Honours noise_floor.
- * If no scalar, "improve" means strictly higher gate_completion.
- */
-export declare function isImprovement(candidate: number, incumbent: number | null, goal: GoalSpec): boolean;
-/** Has the scalar/gate target been hit? */
-export declare function isTargetReached(metric: number, gate_completion: number, goal: GoalSpec): boolean;

package/dist/src/autoloop-types.js

@@ -1,130 +0,0 @@
-/**
- * Types for the autoloop feature.
- *
- * Contracts are documented in tasks/autoloop.md. Schemas here are intentionally
- * narrow — additions belong in the design doc first.
- */
-// ─── Validation Helpers ─────────────────────────────────────────────────────
-export class GoalSpecError extends Error {
-    constructor(message) {
-        super(`goal.json: ${message}`);
-        this.name = 'GoalSpecError';
-    }
-}
-export function validateGoalSpec(raw) {
-    if (!raw || typeof raw !== 'object')
-        throw new GoalSpecError('must be an object');
-    const o = raw;
-    if (!Array.isArray(o.gates))
-        throw new GoalSpecError('`gates` must be an array');
-    const gates = o.gates.map((g, i) => validateGate(g, `gates[${i}]`));
-    let scalar;
-    if (o.scalar != null)
-        scalar = validateScalar(o.scalar);
-    let aspirational_gates;
-    if (Array.isArray(o.aspirational_gates)) {
-        aspirational_gates = o.aspirational_gates.map((g, i) => validateGate(g, `aspirational_gates[${i}]`));
-    }
-    if (!o.termination || typeof o.termination !== 'object') {
-        throw new GoalSpecError('`termination` is required');
-    }
-    const termination = validateTermination(o.termination);
-    // Cross-check: if no scalar, gates must be non-empty (otherwise the loop has nothing to ratchet against)
-    if (!scalar && gates.length === 0) {
-        throw new GoalSpecError('must have at least one of `scalar` or `gates`');
-    }
-    return { scalar, gates, aspirational_gates, termination };
-}
-function validateScalar(raw) {
-    const o = raw;
-    if (typeof o.name !== 'string')
-        throw new GoalSpecError('scalar.name must be string');
-    if (o.direction !== 'min' && o.direction !== 'max') {
-        throw new GoalSpecError('scalar.direction must be "min" or "max"');
-    }
-    if (typeof o.extract_cmd !== 'string' || !o.extract_cmd.trim()) {
-        throw new GoalSpecError('scalar.extract_cmd must be a non-empty string');
-    }
-    return {
-        name: o.name,
-        direction: o.direction,
-        extract_cmd: o.extract_cmd,
-        extract_timeout_sec: typeof o.extract_timeout_sec === 'number' && o.extract_timeout_sec > 0 ? o.extract_timeout_sec : 600,
-        target: typeof o.target === 'number' ? o.target : undefined,
-        noise_floor: typeof o.noise_floor === 'number' ? o.noise_floor : 0,
-    };
-}
-function validateGate(raw, ctx) {
-    const o = raw;
-    if (typeof o.name !== 'string')
-        throw new GoalSpecError(`${ctx}.name must be string`);
-    if (typeof o.cmd !== 'string' || !o.cmd.trim()) {
-        throw new GoalSpecError(`${ctx}.cmd must be a non-empty string`);
-    }
-    if (o.must !== 'exit-0') {
-        throw new GoalSpecError(`${ctx}.must must be "exit-0" (other modes not yet supported)`);
-    }
-    return {
-        name: o.name,
-        cmd: o.cmd,
-        must: 'exit-0',
-        timeout_sec: typeof o.timeout_sec === 'number' && o.timeout_sec > 0 ? o.timeout_sec : 300,
-    };
-}
-function validateTermination(raw) {
-    const o = raw;
-    const num = (k, def) => {
-        if (typeof o[k] === 'number' && Number.isFinite(o[k]))
-            return o[k];
-        if (def !== undefined)
-            return def;
-        throw new GoalSpecError(`termination.${k} must be a number`);
-    };
-    return {
-        scalar_target_hit: o.scalar_target_hit !== false,
-        max_iters: num('max_iters', 200),
-        plateau_iters: num('plateau_iters', 10),
-        max_cost_usd: num('max_cost_usd', 200),
-        max_pending_aspirational: num('max_pending_aspirational', 5),
-    };
-}
-/**
- * Derive the metric value used for ratcheting from an EvalOutput.
- * Rule:
- *   - If goal has a scalar AND eval produced one, use the scalar.
- *   - Otherwise, use gate_completion (∈ [0, 1]).
- */
-export function deriveMetric(eval_out, goal) {
-    if (goal.scalar && eval_out.scalar != null)
-        return eval_out.scalar;
-    return eval_out.gate_completion;
-}
-/**
- * Did `candidate` improve over `incumbent` for this goal? Honours noise_floor.
- * If no scalar, "improve" means strictly higher gate_completion.
- */
-export function isImprovement(candidate, incumbent, goal) {
-    if (incumbent === null)
-        return true;
-    if (goal.scalar) {
-        const noise = goal.scalar.noise_floor ?? 0;
-        if (goal.scalar.direction === 'min')
-            return candidate < incumbent - noise;
-        return candidate > incumbent + noise;
-    }
-    // No scalar: gate_completion, higher is better, no noise floor.
-    return candidate > incumbent;
-}
-/** Has the scalar/gate target been hit? */
-export function isTargetReached(metric, gate_completion, goal) {
-    if (!goal.termination.scalar_target_hit)
-        return false;
-    if (goal.scalar?.target != null) {
-        if (goal.scalar.direction === 'min')
-            return metric <= goal.scalar.target;
-        return metric >= goal.scalar.target;
-    }
-    // No scalar target set; "done" means all gates passing.
-    return gate_completion >= 1.0;
-}
-//# sourceMappingURL=autoloop-types.js.map

package/dist/src/autoloop-types.js.map

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

package/dist/src/autoloop.d.ts

@@ -1,70 +0,0 @@
-/**
- * Autoloop driver — phase machine for autonomous workspace iteration.
- *
- * Contract: tasks/autoloop.md.  This file implements the runner; phase prompts
- * live in configs/autoloop-*-prompt.md.
- *
- * Lifecycle (one runner per task):
- *   start() → BOOTSTRAP → loop { PROPOSE → EXECUTE → MEASURE → RATCHET → maybe COMPRESS } → TERMINATED
- *
- * Termination triggers: scalar target hit, max_iters, max_cost_usd, hard error,
- * explicit stop(). Plateau pushes the user but does NOT halt the loop (per
- * design constraint C9 — proactivity).
- */
-import { EventEmitter } from 'node:events';
-import type { SessionManager } from './session-manager.js';
-import type { Logger } from './logger.js';
-import type { EngineType } from './types.js';
-import type { AutoloopConfig, AutoloopHandle } from './autoloop-types.js';
-export declare class AutoloopRunner extends EventEmitter {
-    readonly id: string;
-    readonly config: AutoloopConfig;
-    readonly taskDir: string;
-    readonly branch: string;
-    private state;
-    private goal;
-    private stopRequested;
-    private startedAt;
-    private endedAt?;
-    private status;
-    private errorMsg?;
-    private readonly manager;
-    private readonly logger;
-    constructor(manager: SessionManager, config: AutoloopConfig, logger?: Logger);
-    /** Start the loop. Resolves after BOOTSTRAP; iteration runs in the background. */
-    start(): Promise<void>;
-    /**
-     * Resume an interrupted autoloop from on-disk state. Skips BOOTSTRAP and
-     * jumps straight to the iteration loop. Resets the workspace to the last
-     * known best (or the BOOTSTRAP baseline if no best yet) so any half-finished
-     * PROPOSE that crashed mid-flight is discarded.
-     */
-    resume(): Promise<void>;
-    /** Ask the loop to halt at the next phase boundary. Resolves when actually stopped. */
-    stop(): Promise<void>;
-    /** Inject a hint that the next PROPOSE will read. */
-    inject(text: string): void;
-    /** Cheap status snapshot from in-memory state. */
-    handle(): AutoloopHandle;
-    private prepareTaskDir;
-    private loadAndValidateGoal;
-    private initialState;
-    private ensureBranch;
-    private runBootstrap;
-    private runLoop;
-    private runPropose;
-    private runExecute;
-    private runMeasure;
-    private runRatchet;
-    private runCompress;
-    private persistState;
-    private gitSha;
-    private gitReset;
-    private readMetricHistory;
-    private readLastRatchet;
-    private tryRead;
-    private push;
-    private terminate;
-    private fail;
-}
-export type { EngineType };