@hasna/loops 0.3.5 → 0.3.7

package/dist/cli/index.js

@@ -236,6 +236,82 @@ function parseDuration(input) {
   return Math.round(value * multiplier);
 }
 
+// src/lib/goal/types.ts
+var GOAL_TERMINAL = ["budgetLimited", "complete", "cancelled"];
+var GOAL_OBJECTIVE_MAX_CHARS = 4000;
+
+// src/lib/goal/status.ts
+function isTerminal(status) {
+  return GOAL_TERMINAL.includes(status);
+}
+function nodeBudgetExhausted(node) {
+  return node.tokenBudget !== undefined && node.tokensUsed >= node.tokenBudget;
+}
+function readyNodeKeys(plan) {
+  if (plan.status !== "active")
+    return [];
+  const byKey = new Map(plan.nodes.map((node) => [node.key, node]));
+  return plan.nodes.filter((node) => {
+    if (node.status !== "pending")
+      return false;
+    if (nodeBudgetExhausted(node))
+      return false;
+    return node.dependsOn.every((dependency) => byKey.get(dependency)?.status === "complete");
+  }).sort((a, b) => b.priority - a.priority || a.sequence - b.sequence || a.key.localeCompare(b.key)).map((node) => node.key);
+}
+function rollupSummary(nodes) {
+  const rollup = {
+    total: nodes.length,
+    pending: 0,
+    active: 0,
+    paused: 0,
+    blocked: 0,
+    usageLimited: 0,
+    budgetLimited: 0,
+    complete: 0,
+    cancelled: 0
+  };
+  for (const node of nodes) {
+    if (node.status in rollup) {
+      rollup[node.status] += 1;
+    }
+  }
+  return rollup;
+}
+function assertGoalTransition(from, to) {
+  if (isTerminal(from) && from !== to) {
+    throw new Error(`cannot transition terminal goal status ${from} to ${to}`);
+  }
+}
+function assertAcyclicNodes(nodes) {
+  const byKey = new Map(nodes.map((node) => [node.key, node]));
+  const visiting = new Set;
+  const visited = new Set;
+  function visit(key) {
+    if (visited.has(key))
+      return;
+    if (visiting.has(key))
+      throw new Error(`goal dependency cycle includes node ${key}`);
+    const node = byKey.get(key);
+    if (!node)
+      throw new Error(`goal plan references missing node ${key}`);
+    visiting.add(key);
+    for (const dependency of node.dependsOn) {
+      if (!byKey.has(dependency))
+        throw new Error(`goal node ${key} depends on missing node ${dependency}`);
+      visit(dependency);
+    }
+    visiting.delete(key);
+    visited.add(key);
+  }
+  for (const node of nodes)
+    visit(node.key);
+}
+function updateReadyFlags(nodes, planStatus) {
+  const ready = new Set(readyNodeKeys({ status: planStatus, nodes }));
+  return nodes.map((node) => ({ ...node, ready: ready.has(node.key) }));
+}
+
 // src/lib/workflow-spec.ts
 function assertObject(value, label) {
   if (!value || typeof value !== "object" || Array.isArray(value))
@@ -245,6 +321,35 @@ function assertString(value, label) {
   if (typeof value !== "string" || value.trim() === "")
     throw new Error(`${label} must be a non-empty string`);
 }
+function optionalPositiveInteger(value, label) {
+  if (value === undefined)
+    return;
+  if (!Number.isInteger(value) || value <= 0)
+    throw new Error(`${label} must be a positive integer`);
+  return value;
+}
+function normalizeGoalSpec(value, label = "goal") {
+  if (value === undefined)
+    return;
+  assertObject(value, label);
+  assertString(value.objective, `${label}.objective`);
+  const objective = value.objective.trim();
+  if (objective.length > GOAL_OBJECTIVE_MAX_CHARS) {
+    throw new Error(`${label}.objective must be ${GOAL_OBJECTIVE_MAX_CHARS} characters or fewer`);
+  }
+  const autoExecute = value.autoExecute === undefined ? undefined : String(value.autoExecute);
+  if (autoExecute !== undefined && !["off", "readyOnly", "aiDirected"].includes(autoExecute)) {
+    throw new Error(`${label}.autoExecute must be off, readyOnly, or aiDirected`);
+  }
+  return {
+    objective,
+    tokenBudget: optionalPositiveInteger(value.tokenBudget, `${label}.tokenBudget`),
+    maxTurns: optionalPositiveInteger(value.maxTurns, `${label}.maxTurns`),
+    maxTokens: optionalPositiveInteger(value.maxTokens, `${label}.maxTokens`),
+    model: typeof value.model === "string" && value.model.trim() ? value.model.trim() : undefined,
+    autoExecute
+  };
+}
 function validateTarget(value, label) {
   assertObject(value, label);
   if (value.type === "command") {
@@ -271,6 +376,7 @@ function validateTarget(value, label) {
 }
 function normalizeCreateWorkflowInput(input) {
   assertString(input.name, "workflow.name");
+  const goal = normalizeGoalSpec(input.goal, "goal");
   if (!Array.isArray(input.steps) || input.steps.length === 0)
     throw new Error("workflow.steps must contain at least one step");
   const seen = new Set;
@@ -283,6 +389,7 @@ function normalizeCreateWorkflowInput(input) {
     return {
       ...step,
       id: step.id,
+      goal: normalizeGoalSpec(step.goal, `workflow.steps[${index}].goal`),
       target: validateTarget(step.target, `workflow.steps[${index}].target`),
       dependsOn: step.dependsOn ?? [],
       continueOnFailure: step.continueOnFailure ?? false
@@ -297,7 +404,7 @@ function normalizeCreateWorkflowInput(input) {
     }
   }
   workflowExecutionOrder({ steps });
-  return { ...input, name: input.name.trim(), version: input.version ?? 1, steps };
+  return { ...input, name: input.name.trim(), goal, version: input.version ?? 1, steps };
 }
 function workflowExecutionOrder(workflow) {
   const byId = new Map(workflow.steps.map((step) => [step.id, step]));
@@ -333,6 +440,7 @@ function workflowBodyFromJson(value, fallbackName) {
   return normalizeCreateWorkflowInput({
     name: rawName,
     description: typeof value.description === "string" ? value.description : undefined,
+    goal: normalizeGoalSpec(value.goal, "goal"),
     version: typeof value.version === "number" ? value.version : undefined,
     steps: value.steps
   });
@@ -347,6 +455,7 @@ function rowToLoop(row) {
     status: row.status,
     schedule: JSON.parse(row.schedule_json),
     target: JSON.parse(row.target_json),
+    goal: row.goal_json ? JSON.parse(row.goal_json) : undefined,
     machine: row.machine_json ? JSON.parse(row.machine_json) : undefined,
     nextRunAt: row.next_run_at ?? undefined,
     retryScheduledFor: row.retry_scheduled_for ?? undefined,
@@ -379,6 +488,7 @@ function rowToRun(row) {
     stdout: row.stdout ?? undefined,
     stderr: row.stderr ?? undefined,
     error: row.error ?? undefined,
+    goalRunId: row.goal_run_id ?? undefined,
     createdAt: row.created_at,
     updatedAt: row.updated_at
   };
@@ -390,6 +500,7 @@ function rowToWorkflow(row) {
     description: row.description ?? undefined,
     version: row.version,
     status: row.status,
+    goal: row.goal_json ? JSON.parse(row.goal_json) : undefined,
     steps: JSON.parse(row.steps_json),
     createdAt: row.created_at,
     updatedAt: row.updated_at
@@ -409,6 +520,7 @@ function rowToWorkflowRun(row) {
     finishedAt: row.finished_at ?? undefined,
     durationMs: row.duration_ms ?? undefined,
     error: row.error ?? undefined,
+    goalRunId: row.goal_run_id ?? undefined,
     createdAt: row.created_at,
     updatedAt: row.updated_at
   };
@@ -430,6 +542,68 @@ function rowToWorkflowStepRun(row) {
     error: row.error ?? undefined,
     accountProfile: row.account_profile ?? undefined,
     accountTool: row.account_tool ?? undefined,
+    goalRunId: row.goal_run_id ?? undefined,
+    createdAt: row.created_at,
+    updatedAt: row.updated_at
+  };
+}
+function rowToGoal(row) {
+  return {
+    goalId: row.id,
+    planId: row.plan_id,
+    objective: row.objective,
+    status: row.status,
+    tokenBudget: row.token_budget ?? undefined,
+    tokensUsed: row.tokens_used,
+    timeUsedSeconds: row.time_used_seconds,
+    autoExecute: row.auto_execute,
+    maxTokens: row.max_tokens ?? undefined,
+    sourceType: row.source_type ?? undefined,
+    sourceId: row.source_id ?? undefined,
+    loopId: row.loop_id ?? undefined,
+    loopRunId: row.loop_run_id ?? undefined,
+    workflowId: row.workflow_id ?? undefined,
+    workflowRunId: row.workflow_run_id ?? undefined,
+    workflowStepId: row.workflow_step_id ?? undefined,
+    createdAt: row.created_at,
+    updatedAt: row.updated_at
+  };
+}
+function rowToGoalPlanNode(row) {
+  return {
+    nodeId: row.id,
+    planId: row.plan_id,
+    key: row.key,
+    sequence: row.sequence,
+    priority: row.priority,
+    objective: row.objective,
+    status: row.status,
+    ready: row.ready === 1,
+    tokenBudget: row.token_budget ?? undefined,
+    tokensUsed: row.tokens_used,
+    timeUsedSeconds: row.time_used_seconds,
+    dependsOn: JSON.parse(row.depends_on_json),
+    createdAt: row.created_at,
+    updatedAt: row.updated_at
+  };
+}
+function rowToGoalRun(row) {
+  return {
+    runId: row.id,
+    goalId: row.goal_id,
+    planId: row.plan_id,
+    loopId: row.loop_id ?? undefined,
+    loopRunId: row.loop_run_id ?? undefined,
+    workflowId: row.workflow_id ?? undefined,
+    workflowRunId: row.workflow_run_id ?? undefined,
+    workflowStepId: row.workflow_step_id ?? undefined,
+    turn: row.turn,
+    phase: row.phase,
+    status: row.status,
+    nodeKey: row.node_key ?? undefined,
+    tokensUsed: row.tokens_used,
+    evidence: row.evidence_json ? JSON.parse(row.evidence_json) : undefined,
+    rawResponse: row.raw_response_json ? JSON.parse(row.raw_response_json) : undefined,
     createdAt: row.created_at,
     updatedAt: row.updated_at
   };
@@ -490,6 +664,7 @@ class Store {
         status TEXT NOT NULL,
         schedule_json TEXT NOT NULL,
         target_json TEXT NOT NULL,
+        goal_json TEXT,
         machine_json TEXT,
         next_run_at TEXT,
         retry_scheduled_for TEXT,
@@ -523,6 +698,7 @@ class Store {
         stdout TEXT,
         stderr TEXT,
         error TEXT,
+        goal_run_id TEXT,
         created_at TEXT NOT NULL,
         updated_at TEXT NOT NULL,
         UNIQUE(loop_id, scheduled_for)
@@ -547,6 +723,7 @@ class Store {
         description TEXT,
         version INTEGER NOT NULL,
         status TEXT NOT NULL,
+        goal_json TEXT,
         steps_json TEXT NOT NULL,
         created_at TEXT NOT NULL,
         updated_at TEXT NOT NULL
@@ -567,6 +744,7 @@ class Store {
         finished_at TEXT,
         duration_ms INTEGER,
         error TEXT,
+        goal_run_id TEXT,
         created_at TEXT NOT NULL,
         updated_at TEXT NOT NULL
       );
@@ -593,6 +771,7 @@ class Store {
         error TEXT,
         account_profile TEXT,
         account_tool TEXT,
+        goal_run_id TEXT,
         created_at TEXT NOT NULL,
         updated_at TEXT NOT NULL,
         UNIQUE(workflow_run_id, step_id)
@@ -611,15 +790,100 @@ class Store {
         UNIQUE(workflow_run_id, sequence)
       );
       CREATE INDEX IF NOT EXISTS idx_workflow_events_run_sequence ON workflow_events(workflow_run_id, sequence);
+
+      CREATE TABLE IF NOT EXISTS goals (
+        id TEXT PRIMARY KEY,
+        plan_id TEXT NOT NULL,
+        objective TEXT NOT NULL,
+        status TEXT NOT NULL,
+        token_budget INTEGER,
+        tokens_used INTEGER NOT NULL,
+        time_used_seconds INTEGER NOT NULL,
+        auto_execute TEXT NOT NULL,
+        max_tokens INTEGER,
+        source_type TEXT,
+        source_id TEXT,
+        loop_id TEXT,
+        loop_run_id TEXT,
+        workflow_id TEXT,
+        workflow_run_id TEXT,
+        workflow_step_id TEXT,
+        created_at TEXT NOT NULL,
+        updated_at TEXT NOT NULL
+      );
+      CREATE INDEX IF NOT EXISTS idx_goals_status_updated ON goals(status, updated_at DESC);
+      CREATE INDEX IF NOT EXISTS idx_goals_loop_run ON goals(loop_run_id);
+      CREATE INDEX IF NOT EXISTS idx_goals_workflow_run ON goals(workflow_run_id);
+      CREATE INDEX IF NOT EXISTS idx_goals_source ON goals(source_type, source_id);
+
+      CREATE TABLE IF NOT EXISTS goal_plan_nodes (
+        id TEXT PRIMARY KEY,
+        goal_id TEXT NOT NULL REFERENCES goals(id) ON DELETE CASCADE,
+        plan_id TEXT NOT NULL,
+        key TEXT NOT NULL,
+        sequence INTEGER NOT NULL,
+        priority INTEGER NOT NULL,
+        objective TEXT NOT NULL,
+        status TEXT NOT NULL,
+        ready INTEGER NOT NULL,
+        token_budget INTEGER,
+        tokens_used INTEGER NOT NULL,
+        time_used_seconds INTEGER NOT NULL,
+        depends_on_json TEXT NOT NULL,
+        created_at TEXT NOT NULL,
+        updated_at TEXT NOT NULL,
+        UNIQUE(plan_id, key)
+      );
+      CREATE INDEX IF NOT EXISTS idx_goal_plan_nodes_goal_sequence ON goal_plan_nodes(goal_id, sequence);
+      CREATE INDEX IF NOT EXISTS idx_goal_plan_nodes_status ON goal_plan_nodes(status);
+
+      CREATE TABLE IF NOT EXISTS goal_runs (
+        id TEXT PRIMARY KEY,
+        goal_id TEXT NOT NULL REFERENCES goals(id) ON DELETE CASCADE,
+        plan_id TEXT NOT NULL,
+        loop_id TEXT,
+        loop_run_id TEXT,
+        workflow_id TEXT,
+        workflow_run_id TEXT,
+        workflow_step_id TEXT,
+        turn INTEGER NOT NULL,
+        phase TEXT NOT NULL,
+        status TEXT NOT NULL,
+        node_key TEXT,
+        tokens_used INTEGER NOT NULL,
+        evidence_json TEXT,
+        raw_response_json TEXT,
+        created_at TEXT NOT NULL,
+        updated_at TEXT NOT NULL
+      );
+      CREATE INDEX IF NOT EXISTS idx_goal_runs_goal_created ON goal_runs(goal_id, created_at);
+      CREATE INDEX IF NOT EXISTS idx_goal_runs_loop_run ON goal_runs(loop_run_id);
+      CREATE INDEX IF NOT EXISTS idx_goal_runs_workflow_run ON goal_runs(workflow_run_id);
     `);
     try {
       this.db.query("ALTER TABLE loops ADD COLUMN machine_json TEXT").run();
     } catch {}
+    try {
+      this.db.query("ALTER TABLE loops ADD COLUMN goal_json TEXT").run();
+    } catch {}
+    try {
+      this.db.query("ALTER TABLE loop_runs ADD COLUMN goal_run_id TEXT").run();
+    } catch {}
+    try {
+      this.db.query("ALTER TABLE workflow_specs ADD COLUMN goal_json TEXT").run();
+    } catch {}
+    try {
+      this.db.query("ALTER TABLE workflow_runs ADD COLUMN goal_run_id TEXT").run();
+    } catch {}
     try {
       this.db.query("ALTER TABLE workflow_step_runs ADD COLUMN pid INTEGER").run();
     } catch {}
+    try {
+      this.db.query("ALTER TABLE workflow_step_runs ADD COLUMN goal_run_id TEXT").run();
+    } catch {}
     this.db.query("INSERT OR IGNORE INTO schema_migrations (id, applied_at) VALUES (?, ?)").run("0001_initial_and_workflows", nowIso());
     this.db.query("INSERT OR IGNORE INTO schema_migrations (id, applied_at) VALUES (?, ?)").run("0002_loop_machines", nowIso());
+    this.db.query("INSERT OR IGNORE INTO schema_migrations (id, applied_at) VALUES (?, ?)").run("0003_goals", nowIso());
   }
   assertDaemonLeaseFence(opts = {}, now = nowIso()) {
     if (!opts.daemonLeaseId)
@@ -637,6 +901,7 @@ class Store {
       status: "active",
       schedule: input.schedule,
       target: input.target,
+      goal: input.goal,
       machine: input.machine,
       nextRunAt: initialNextRun(input.schedule, from),
       catchUp: input.catchUp ?? "latest",
@@ -650,8 +915,8 @@ class Store {
       updatedAt: now
     };
     this.db.query(`INSERT INTO loops (id, name, description, status, schedule_json, target_json, machine_json, next_run_at, retry_scheduled_for,
-          catch_up, catch_up_limit, overlap, max_attempts, retry_delay_ms, lease_ms, expires_at, created_at, updated_at)
-         VALUES ($id, $name, $description, $status, $schedule, $target, $machine, $nextRun, NULL, $catchUp, $catchUpLimit,
+          goal_json, catch_up, catch_up_limit, overlap, max_attempts, retry_delay_ms, lease_ms, expires_at, created_at, updated_at)
+         VALUES ($id, $name, $description, $status, $schedule, $target, $machine, $nextRun, NULL, $goal, $catchUp, $catchUpLimit,
           $overlap, $maxAttempts, $retryDelay, $leaseMs, $expiresAt, $created, $updated)`).run({
       $id: loop.id,
       $name: loop.name,
@@ -660,6 +925,7 @@ class Store {
       $schedule: JSON.stringify(loop.schedule),
       $target: JSON.stringify(loop.target),
       $machine: loop.machine ? JSON.stringify(loop.machine) : null,
+      $goal: loop.goal ? JSON.stringify(loop.goal) : null,
       $nextRun: loop.nextRunAt ?? null,
       $catchUp: loop.catchUp,
       $catchUpLimit: loop.catchUpLimit,
@@ -739,17 +1005,19 @@ class Store {
       description: normalized.description,
       version: normalized.version ?? 1,
       status: "active",
+      goal: normalized.goal,
       steps: normalized.steps,
       createdAt: now,
       updatedAt: now
     };
-    this.db.query(`INSERT INTO workflow_specs (id, name, description, version, status, steps_json, created_at, updated_at)
-         VALUES ($id, $name, $description, $version, $status, $steps, $created, $updated)`).run({
+    this.db.query(`INSERT INTO workflow_specs (id, name, description, version, status, goal_json, steps_json, created_at, updated_at)
+         VALUES ($id, $name, $description, $version, $status, $goal, $steps, $created, $updated)`).run({
       $id: workflow.id,
       $name: workflow.name,
       $description: workflow.description ?? null,
       $version: workflow.version,
       $status: workflow.status,
+      $goal: workflow.goal ? JSON.stringify(workflow.goal) : null,
       $steps: JSON.stringify(workflow.steps),
       $created: workflow.createdAt,
       $updated: workflow.updatedAt
@@ -783,6 +1051,277 @@ class Store {
       throw new Error(`workflow not found after archive: ${workflow.id}`);
     return archived;
   }
+  createGoal(input, opts = {}) {
+    const now = nowIso();
+    this.db.exec("BEGIN IMMEDIATE");
+    try {
+      this.assertDaemonLeaseFence(opts, now);
+      const id = genId();
+      this.db.query(`INSERT INTO goals (id, plan_id, objective, status, token_budget, tokens_used, time_used_seconds, auto_execute,
+            max_tokens, source_type, source_id, loop_id, loop_run_id, workflow_id, workflow_run_id, workflow_step_id,
+            created_at, updated_at)
+           VALUES ($id, $planId, $objective, 'active', $tokenBudget, 0, 0, $autoExecute, $maxTokens, $sourceType,
+            $sourceId, $loopId, $loopRunId, $workflowId, $workflowRunId, $workflowStepId, $created, $updated)`).run({
+        $id: id,
+        $planId: id,
+        $objective: input.objective,
+        $tokenBudget: input.tokenBudget ?? null,
+        $autoExecute: input.autoExecute ?? "readyOnly",
+        $maxTokens: input.maxTokens ?? input.tokenBudget ?? null,
+        $sourceType: input.sourceType ?? null,
+        $sourceId: input.sourceId ?? null,
+        $loopId: input.loopId ?? null,
+        $loopRunId: input.loopRunId ?? null,
+        $workflowId: input.workflowId ?? null,
+        $workflowRunId: input.workflowRunId ?? null,
+        $workflowStepId: input.workflowStepId ?? null,
+        $created: now,
+        $updated: now
+      });
+      this.db.exec("COMMIT");
+      return this.requireGoal(id);
+    } catch (error) {
+      try {
+        this.db.exec("ROLLBACK");
+      } catch {}
+      throw error;
+    }
+  }
+  getGoal(id) {
+    const row = this.db.query("SELECT * FROM goals WHERE id = ?").get(id);
+    return row ? rowToGoal(row) : undefined;
+  }
+  requireGoal(id) {
+    const goal = this.getGoal(id);
+    if (!goal)
+      throw new Error(`goal not found: ${id}`);
+    return goal;
+  }
+  findGoalByLoop(idOrName) {
+    const loop = this.getLoop(idOrName) ?? this.findLoopByName(idOrName);
+    if (!loop)
+      return;
+    const row = this.db.query("SELECT * FROM goals WHERE loop_id = ? ORDER BY created_at DESC LIMIT 1").get(loop.id);
+    return row ? rowToGoal(row) : undefined;
+  }
+  findGoalByRunId(id) {
+    const direct = this.getGoal(id);
+    if (direct)
+      return direct;
+    const event = this.db.query("SELECT * FROM goal_runs WHERE id = ?").get(id);
+    if (event)
+      return this.getGoal(event.goal_id);
+    const row = this.db.query(`SELECT * FROM goals
+         WHERE loop_run_id = ? OR workflow_run_id = ? OR workflow_step_id = ?
+         ORDER BY created_at DESC LIMIT 1`).get(id, id, id);
+    return row ? rowToGoal(row) : undefined;
+  }
+  findGoalByContext(context) {
+    if (context.loopRunId) {
+      const row = this.db.query(`SELECT * FROM goals
+           WHERE loop_run_id = ? AND (? IS NULL OR workflow_step_id = ?)
+           ORDER BY created_at DESC LIMIT 1`).get(context.loopRunId, context.workflowStepId ?? null, context.workflowStepId ?? null);
+      if (row)
+        return rowToGoal(row);
+    }
+    if (context.workflowRunId) {
+      const row = this.db.query(`SELECT * FROM goals
+           WHERE workflow_run_id = ? AND (? IS NULL OR workflow_step_id = ?)
+           ORDER BY created_at DESC LIMIT 1`).get(context.workflowRunId, context.workflowStepId ?? null, context.workflowStepId ?? null);
+      if (row)
+        return rowToGoal(row);
+    }
+    if (context.sourceType && context.sourceId) {
+      const row = this.db.query("SELECT * FROM goals WHERE source_type = ? AND source_id = ? ORDER BY created_at DESC LIMIT 1").get(context.sourceType, context.sourceId);
+      if (row)
+        return rowToGoal(row);
+    }
+    return;
+  }
+  listGoals(opts = {}) {
+    const limit = opts.limit ?? 100;
+    const rows = opts.status ? this.db.query("SELECT * FROM goals WHERE status = ? ORDER BY created_at DESC LIMIT ?").all(opts.status, limit) : this.db.query("SELECT * FROM goals ORDER BY created_at DESC LIMIT ?").all(limit);
+    return rows.map(rowToGoal);
+  }
+  createGoalPlanNodes(goalId, nodes, opts = {}) {
+    const goal = this.requireGoal(goalId);
+    const now = nowIso();
+    const materialized = nodes.map((node, sequence) => ({
+      nodeId: genId(),
+      planId: goal.planId,
+      key: node.key,
+      sequence,
+      priority: node.priority ?? 0,
+      objective: node.objective,
+      status: "pending",
+      ready: false,
+      tokenBudget: node.tokenBudget,
+      tokensUsed: 0,
+      timeUsedSeconds: 0,
+      dependsOn: node.dependsOn ?? [],
+      createdAt: now,
+      updatedAt: now
+    }));
+    const withReady = updateReadyFlags(materialized, "active");
+    this.db.exec("BEGIN IMMEDIATE");
+    try {
+      this.assertDaemonLeaseFence(opts, now);
+      for (const node of withReady) {
+        this.db.query(`INSERT OR IGNORE INTO goal_plan_nodes (id, goal_id, plan_id, key, sequence, priority, objective, status, ready,
+              token_budget, tokens_used, time_used_seconds, depends_on_json, created_at, updated_at)
+             VALUES ($id, $goalId, $planId, $key, $sequence, $priority, $objective, $status, $ready, $tokenBudget,
+              $tokensUsed, $timeUsedSeconds, $dependsOn, $created, $updated)`).run({
+          $id: node.nodeId,
+          $goalId: goal.goalId,
+          $planId: goal.planId,
+          $key: node.key,
+          $sequence: node.sequence,
+          $priority: node.priority,
+          $objective: node.objective,
+          $status: node.status,
+          $ready: node.ready ? 1 : 0,
+          $tokenBudget: node.tokenBudget ?? null,
+          $tokensUsed: node.tokensUsed,
+          $timeUsedSeconds: node.timeUsedSeconds,
+          $dependsOn: JSON.stringify(node.dependsOn),
+          $created: node.createdAt,
+          $updated: node.updatedAt
+        });
+      }
+      this.db.exec("COMMIT");
+    } catch (error) {
+      try {
+        this.db.exec("ROLLBACK");
+      } catch {}
+      throw error;
+    }
+    return this.listGoalPlanNodes(goalId);
+  }
+  listGoalPlanNodes(goalIdOrPlanId) {
+    const rows = this.db.query("SELECT * FROM goal_plan_nodes WHERE goal_id = ? OR plan_id = ? ORDER BY sequence ASC").all(goalIdOrPlanId, goalIdOrPlanId);
+    return rows.map(rowToGoalPlanNode);
+  }
+  updateGoalStatus(goalId, status, opts = {}) {
+    const current = this.requireGoal(goalId);
+    assertGoalTransition(current.status, status);
+    const now = (opts.now ?? new Date).toISOString();
+    this.db.query(`UPDATE goals SET status=$status, updated_at=$updated
+         WHERE id=$id
+           AND ($daemonLeaseId IS NULL OR EXISTS (
+             SELECT 1 FROM daemon_lease WHERE id=$daemonLeaseId AND expires_at > $now
+           ))`).run({
+      $id: goalId,
+      $status: status,
+      $updated: now,
+      $daemonLeaseId: opts.daemonLeaseId ?? null,
+      $now: now
+    });
+    return this.requireGoal(goalId);
+  }
+  addGoalUsage(goalId, tokens, timeUsedSeconds = 0, opts = {}) {
+    const now = (opts.now ?? new Date).toISOString();
+    this.db.query(`UPDATE goals
+         SET tokens_used=tokens_used + $tokens, time_used_seconds=time_used_seconds + $seconds, updated_at=$updated
+         WHERE id=$id
+           AND ($daemonLeaseId IS NULL OR EXISTS (
+             SELECT 1 FROM daemon_lease WHERE id=$daemonLeaseId AND expires_at > $now
+           ))`).run({
+      $id: goalId,
+      $tokens: tokens,
+      $seconds: timeUsedSeconds,
+      $updated: now,
+      $daemonLeaseId: opts.daemonLeaseId ?? null,
+      $now: now
+    });
+    return this.requireGoal(goalId);
+  }
+  updateGoalPlanNode(goalId, key, patch, opts = {}) {
+    const now = (opts.now ?? new Date).toISOString();
+    this.db.query(`UPDATE goal_plan_nodes
+         SET status=COALESCE($status, status),
+          tokens_used=COALESCE($tokensUsed, tokens_used),
+          time_used_seconds=COALESCE($timeUsedSeconds, time_used_seconds),
+          ready=COALESCE($ready, ready),
+          updated_at=$updated
+         WHERE goal_id=$goalId AND key=$key
+           AND ($daemonLeaseId IS NULL OR EXISTS (
+             SELECT 1 FROM daemon_lease WHERE id=$daemonLeaseId AND expires_at > $now
+           ))`).run({
+      $goalId: goalId,
+      $key: key,
+      $status: patch.status ?? null,
+      $tokensUsed: patch.tokensUsed ?? null,
+      $timeUsedSeconds: patch.timeUsedSeconds ?? null,
+      $ready: patch.ready === undefined ? null : patch.ready ? 1 : 0,
+      $updated: now,
+      $daemonLeaseId: opts.daemonLeaseId ?? null,
+      $now: now
+    });
+    const node = this.listGoalPlanNodes(goalId).find((entry) => entry.key === key);
+    if (!node)
+      throw new Error(`goal node not found: ${goalId}/${key}`);
+    return node;
+  }
+  recordGoalEvent(input, opts = {}) {
+    const goal = this.requireGoal(input.goalId);
+    const now = nowIso();
+    this.db.exec("BEGIN IMMEDIATE");
+    try {
+      this.assertDaemonLeaseFence(opts, now);
+      const previous = this.db.query("SELECT MAX(turn) AS turn FROM goal_runs WHERE goal_id = ?").get(goal.goalId);
+      const turn = input.turn ?? (previous?.turn ?? 0) + 1;
+      const id = genId();
+      this.db.query(`INSERT INTO goal_runs (id, goal_id, plan_id, loop_id, loop_run_id, workflow_id, workflow_run_id, workflow_step_id,
+            turn, phase, status, node_key, tokens_used, evidence_json, raw_response_json, created_at, updated_at)
+           VALUES ($id, $goalId, $planId, $loopId, $loopRunId, $workflowId, $workflowRunId, $workflowStepId,
+            $turn, $phase, $status, $nodeKey, $tokensUsed, $evidence, $rawResponse, $created, $updated)`).run({
+        $id: id,
+        $goalId: goal.goalId,
+        $planId: goal.planId,
+        $loopId: goal.loopId ?? null,
+        $loopRunId: goal.loopRunId ?? null,
+        $workflowId: goal.workflowId ?? null,
+        $workflowRunId: goal.workflowRunId ?? null,
+        $workflowStepId: goal.workflowStepId ?? null,
+        $turn: turn,
+        $phase: input.phase,
+        $status: input.status,
+        $nodeKey: input.nodeKey ?? null,
+        $tokensUsed: input.tokensUsed ?? 0,
+        $evidence: input.evidence ? JSON.stringify(input.evidence) : null,
+        $rawResponse: input.rawResponse === undefined ? null : JSON.stringify(input.rawResponse),
+        $created: now,
+        $updated: now
+      });
+      if (input.tokensUsed && input.tokensUsed > 0) {
+        this.db.query("UPDATE goals SET tokens_used=tokens_used + ?, updated_at=? WHERE id=?").run(input.tokensUsed, now, goal.goalId);
+      }
+      this.db.exec("COMMIT");
+      const event = this.db.query("SELECT * FROM goal_runs WHERE id = ?").get(id);
+      if (!event)
+        throw new Error(`goal run not found after record: ${id}`);
+      return rowToGoalRun(event);
+    } catch (error) {
+      try {
+        this.db.exec("ROLLBACK");
+      } catch {}
+      throw error;
+    }
+  }
+  listGoalRuns(opts = {}) {
+    const limit = opts.limit ?? 200;
+    let rows;
+    if (opts.goalId) {
+      rows = this.db.query("SELECT * FROM goal_runs WHERE goal_id = ? ORDER BY created_at ASC LIMIT ?").all(opts.goalId, limit);
+    } else if (opts.runId) {
+      rows = this.db.query(`SELECT * FROM goal_runs
+           WHERE id = ? OR loop_run_id = ? OR workflow_run_id = ?
+           ORDER BY created_at ASC LIMIT ?`).all(opts.runId, opts.runId, opts.runId, limit);
+    } else {
+      rows = this.db.query("SELECT * FROM goal_runs ORDER BY created_at DESC LIMIT ?").all(limit);
+    }
+    return rows.map(rowToGoalRun);
+  }
   createWorkflowRun(input) {
     const now = nowIso();
     if (input.idempotencyKey) {
@@ -1608,9 +2147,23 @@ function publicWorkflowStepRun(run, showOutput = false) {
 function publicWorkflowEvent(event) {
   return { ...event, payload: redactSensitivePayload(event.payload) };
 }
+function publicGoal(goal) {
+  return {
+    ...goal,
+    objective: redact(goal.objective, 120)
+  };
+}
+function publicGoalRun(run) {
+  return {
+    ...run,
+    evidence: redactSensitivePayload(run.evidence),
+    rawResponse: redactSensitivePayload(run.rawResponse)
+  };
+}
 
 // src/lib/executor.ts
 import { spawn, spawnSync as spawnSync2 } from "child_process";
+import { randomBytes as randomBytes2 } from "crypto";
 import { once } from "events";
 import { resolveMachineCommand } from "@hasna/machines/consumer";
 
@@ -1906,6 +2459,12 @@ function metadataEnv(metadata) {
     env.LOOPS_WORKFLOW_RUN_ID = metadata.workflowRunId;
   if (metadata.workflowStepId)
     env.LOOPS_WORKFLOW_STEP_ID = metadata.workflowStepId;
+  if (metadata.goalId)
+    env.LOOPS_GOAL_ID = metadata.goalId;
+  if (metadata.goalObjective)
+    env.LOOPS_GOAL_OBJECTIVE = metadata.goalObjective;
+  if (metadata.goalNodeKey)
+    env.LOOPS_GOAL_NODE_KEY = metadata.goalNodeKey;
   return env;
 }
 function providerCommand(provider) {
@@ -2043,9 +2602,9 @@ function commandForShell(spec) {
   return [spec.command, ...spec.args.map(shellQuote)].join(" ");
 }
 function hereDoc(value) {
-  let delimiter2 = `__OPENLOOPS_STDIN_${Math.random().toString(36).slice(2).toUpperCase()}__`;
+  let delimiter2 = `__OPENLOOPS_STDIN_${randomBytes2(8).toString("hex").toUpperCase()}__`;
   while (value.split(/\r?\n/).includes(delimiter2)) {
-    delimiter2 = `__OPENLOOPS_STDIN_${Math.random().toString(36).slice(2).toUpperCase()}__`;
+    delimiter2 = `__OPENLOOPS_STDIN_${randomBytes2(8).toString("hex").toUpperCase()}__`;
   }
   return [`cat > "$__OPENLOOPS_STDIN" <<'${delimiter2}'`, value, delimiter2];
 }
@@ -2369,6 +2928,346 @@ async function executeLoop(loop, run, opts = {}) {
   }, { ...opts, machine: opts.machine ?? loop.machine });
 }
 
+// src/lib/goal/runner.ts
+import { generateObject } from "ai";
+import { z } from "zod";
+
+// src/lib/goal/model-factory.ts
+import { createOpenRouter } from "@openrouter/ai-sdk-provider";
+var DEFAULT_GOAL_MODEL = "openai/gpt-4o-mini";
+function resolveGoalModel(opts = {}) {
+  const env = opts.env ?? process.env;
+  const apiKey = opts.apiKey ?? env.OPENROUTER_API_KEY;
+  if (!apiKey) {
+    throw new Error("OPENROUTER_API_KEY is required to run goals with the OpenRouter AI SDK provider");
+  }
+  const provider = createOpenRouter({
+    apiKey,
+    baseURL: opts.baseURL ?? env.LOOPS_GOAL_BASE_URL ?? env.OPENROUTER_BASE_URL
+  });
+  return provider.chat(opts.model ?? env.LOOPS_GOAL_MODEL ?? DEFAULT_GOAL_MODEL);
+}
+
+// src/lib/goal/prompts.ts
+function planPrompt(spec) {
+  const budget = spec.tokenBudget ? `Token budget: ${spec.tokenBudget}.` : "No explicit token budget.";
+  return [
+    "Create a flat DAG goal plan for this objective.",
+    "Each node must have a stable short key, a concrete objective, optional dependsOn keys, and optional priority.",
+    "Prefer the smallest plan that can prove the explicit requirements.",
+    budget,
+    `Objective: ${spec.objective}`
+  ].join(`
+`);
+}
+function achievementPrompt(goal, nodes, evidence) {
+  return [
+    "Run an adversarial achievement audit.",
+    "Completion is unproven until every explicit requirement is verified against evidence.",
+    "Return achieved=false if evidence is missing, ambiguous, or only asserts completion.",
+    "adversarialReview must be non-empty and must describe the attempted falsification.",
+    `Goal: ${goal.objective}`,
+    `Nodes: ${nodes.map((node) => `${node.key}=${node.status}`).join(", ")}`,
+    `Evidence:
+${evidence.join(`
+---
+`) || "(none)"}`
+  ].join(`
+`);
+}
+
+// src/lib/goal/runner.ts
+var DEFAULT_MAX_TURNS = 10;
+var PlanNodeSchema = z.object({
+  key: z.string().min(1).max(64).regex(/^[A-Za-z0-9_.-]+$/),
+  objective: z.string().min(1),
+  dependsOn: z.array(z.string().min(1)).optional().default([]),
+  priority: z.number().int().optional().default(0),
+  tokenBudget: z.number().int().positive().optional()
+});
+var PlanSchema = z.object({
+  nodes: z.array(PlanNodeSchema).min(1)
+});
+var AchievementSchema = z.object({
+  achieved: z.boolean(),
+  status: z.enum(["active", "blocked", "budgetLimited", "complete", "cancelled"]).optional(),
+  evidence: z.array(z.string()).optional().default([]),
+  unmetRequirements: z.array(z.string()).optional().default([]),
+  adversarialReview: z.string().min(1)
+});
+function normalizeGoalSpec2(spec) {
+  const objective = spec.objective.trim();
+  if (!objective)
+    throw new Error("goal.objective must be a non-empty string");
+  if (objective.length > GOAL_OBJECTIVE_MAX_CHARS) {
+    throw new Error(`goal.objective must be ${GOAL_OBJECTIVE_MAX_CHARS} characters or fewer`);
+  }
+  return { ...spec, objective, autoExecute: spec.autoExecute ?? "readyOnly" };
+}
+function usageTotal(value) {
+  const usage = value;
+  const input = typeof usage.inputTokens === "number" ? usage.inputTokens : usage.inputTokens?.total ?? 0;
+  const output = typeof usage.outputTokens === "number" ? usage.outputTokens : usage.outputTokens?.total ?? 0;
+  return usage.totalTokens ?? input + output;
+}
+function resultFromGoal(goal, status, stdout, error, startedAt = goal.createdAt) {
+  const finishedAt = nowIso();
+  return {
+    status,
+    exitCode: status === "succeeded" ? 0 : 1,
+    stdout,
+    stderr: "",
+    error,
+    startedAt,
+    finishedAt,
+    durationMs: new Date(finishedAt).getTime() - new Date(startedAt).getTime(),
+    goalId: goal.goalId
+  };
+}
+function budgetExhausted(goal) {
+  return goal.tokenBudget !== undefined && goal.tokensUsed >= goal.tokenBudget;
+}
+function sameBlockerKey(values) {
+  return values.map((value) => value.trim()).filter(Boolean).join(`
+`) || "goal completion remains unproven";
+}
+function metadataFor(goal, node, context) {
+  return {
+    loopId: context?.loopId,
+    loopName: context?.loopName,
+    runId: context?.loopRunId,
+    scheduledFor: context?.scheduledFor,
+    workflowId: context?.workflowId,
+    workflowName: context?.workflowName,
+    workflowRunId: context?.workflowRunId,
+    workflowStepId: context?.workflowStepId,
+    goalId: goal.goalId,
+    goalObjective: goal.objective,
+    goalNodeKey: node.key
+  };
+}
+async function executeUnderlyingTarget(target, goal, node, opts) {
+  const metadata = metadataFor(goal, node, opts.context);
+  if (opts.executeNode)
+    return opts.executeNode(node, metadata);
+  if (!target)
+    throw new Error("runGoal requires either target or executeNode");
+  return executeTarget(target, metadata, {
+    env: opts.env,
+    daemonLeaseId: opts.daemonLeaseId,
+    beforePersist: opts.beforePersist,
+    signal: opts.signal
+  });
+}
+async function planGoal(store, goal, spec, model, opts) {
+  const existing = store.listGoalPlanNodes(goal.goalId);
+  if (existing.length > 0)
+    return existing;
+  const planned = await generateObject({
+    model,
+    schema: PlanSchema,
+    temperature: 0,
+    prompt: planPrompt(spec),
+    abortSignal: opts.signal
+  });
+  const tokens = usageTotal(planned.usage);
+  const rawNodes = planned.object.nodes.map((node, index) => ({
+    key: node.key,
+    objective: node.objective,
+    dependsOn: node.dependsOn ?? [],
+    priority: node.priority ?? 0,
+    tokenBudget: node.tokenBudget,
+    sequence: index
+  }));
+  assertAcyclicNodes(rawNodes.map((node) => ({ key: node.key, dependsOn: node.dependsOn })));
+  store.recordGoalEvent({
+    goalId: goal.goalId,
+    turn: 0,
+    phase: "plan",
+    status: "active",
+    tokensUsed: tokens,
+    evidence: { nodeCount: rawNodes.length },
+    rawResponse: planned.object
+  }, { daemonLeaseId: opts.daemonLeaseId });
+  return store.createGoalPlanNodes(goal.goalId, rawNodes, { daemonLeaseId: opts.daemonLeaseId });
+}
+function stdoutFor(goal, nodes, evidence, validation) {
+  return JSON.stringify({
+    goal,
+    rollup: rollupSummary(nodes),
+    nodes,
+    evidence,
+    validation
+  }, null, 2);
+}
+async function runGoal(store, input, opts = {}) {
+  const spec = normalizeGoalSpec2(input);
+  const model = opts.model ?? resolveGoalModel({ model: spec.model, env: opts.env });
+  const startedAt = nowIso();
+  const existing = store.findGoalByContext({
+    loopRunId: opts.context?.loopRunId,
+    workflowRunId: opts.context?.workflowRunId,
+    workflowStepId: opts.context?.workflowStepId,
+    sourceType: opts.context?.loopRunId || opts.context?.workflowRunId ? undefined : "manual",
+    sourceId: opts.context?.loopRunId || opts.context?.workflowRunId ? undefined : spec.objective
+  });
+  let goal = existing ?? store.createGoal({
+    objective: spec.objective,
+    tokenBudget: spec.tokenBudget,
+    autoExecute: spec.autoExecute,
+    maxTokens: spec.maxTokens ?? spec.tokenBudget,
+    sourceType: opts.context?.loopRunId || opts.context?.workflowRunId ? undefined : "manual",
+    sourceId: opts.context?.loopRunId || opts.context?.workflowRunId ? undefined : spec.objective,
+    loopId: opts.context?.loopId,
+    loopRunId: opts.context?.loopRunId,
+    workflowId: opts.context?.workflowId,
+    workflowRunId: opts.context?.workflowRunId,
+    workflowStepId: opts.context?.workflowStepId
+  }, { daemonLeaseId: opts.daemonLeaseId });
+  let nodes = await planGoal(store, goal, spec, model, opts);
+  goal = store.requireGoal(goal.goalId);
+  const evidence = [];
+  let validation;
+  let lastBlocker = "";
+  let repeatedBlockerCount = 0;
+  if (budgetExhausted(goal)) {
+    goal = store.updateGoalStatus(goal.goalId, "budgetLimited", { daemonLeaseId: opts.daemonLeaseId });
+    return resultFromGoal(goal, "failed", stdoutFor(goal, nodes, evidence), "goal token budget exhausted after planning", startedAt);
+  }
+  for (let turn = 1;turn <= (spec.maxTurns ?? DEFAULT_MAX_TURNS); turn++) {
+    if (opts.signal?.aborted) {
+      goal = store.updateGoalStatus(goal.goalId, "cancelled", { daemonLeaseId: opts.daemonLeaseId });
+      return resultFromGoal(goal, "failed", stdoutFor(goal, nodes, evidence), "goal cancelled", startedAt);
+    }
+    goal = store.requireGoal(goal.goalId);
+    nodes = store.listGoalPlanNodes(goal.goalId);
+    if (budgetExhausted(goal)) {
+      goal = store.updateGoalStatus(goal.goalId, "budgetLimited", { daemonLeaseId: opts.daemonLeaseId });
+      return resultFromGoal(goal, "failed", stdoutFor(goal, nodes, evidence), "goal token budget exhausted", startedAt);
+    }
+    const readyKeys = readyNodeKeys({
+      status: goal.status === "active" ? "active" : goal.status === "budgetLimited" ? "budgetLimited" : "blocked",
+      nodes
+    });
+    if (readyKeys.length > 0) {
+      for (const key of readyKeys) {
+        const node = store.listGoalPlanNodes(goal.goalId).find((entry) => entry.key === key);
+        if (!node || node.status !== "pending")
+          continue;
+        opts.beforePersist?.();
+        store.updateGoalPlanNode(goal.goalId, node.key, { status: "active", ready: false }, { daemonLeaseId: opts.daemonLeaseId });
+        const result = await executeUnderlyingTarget(opts.target, goal, node, opts);
+        store.recordGoalEvent({
+          goalId: goal.goalId,
+          turn,
+          phase: "execute",
+          status: result.status === "succeeded" ? "complete" : "active",
+          nodeKey: node.key,
+          evidence: {
+            status: result.status,
+            exitCode: result.exitCode,
+            stdout: result.stdout,
+            stderr: result.stderr,
+            error: result.error
+          }
+        }, { daemonLeaseId: opts.daemonLeaseId });
+        if (result.status === "succeeded") {
+          evidence.push(`node ${node.key} succeeded
+stdout:
+${result.stdout}
+stderr:
+${result.stderr}`);
+          store.updateGoalPlanNode(goal.goalId, node.key, {
+            status: "complete",
+            timeUsedSeconds: Math.round(result.durationMs / 1000)
+          }, { daemonLeaseId: opts.daemonLeaseId });
+          continue;
+        }
+        const blocker2 = `node ${node.key} ${result.status}${result.error ? `: ${result.error}` : ""}`;
+        if (blocker2 === lastBlocker)
+          repeatedBlockerCount += 1;
+        else {
+          lastBlocker = blocker2;
+          repeatedBlockerCount = 1;
+        }
+        store.updateGoalPlanNode(goal.goalId, node.key, { status: repeatedBlockerCount >= 3 ? "blocked" : "pending" }, {
+          daemonLeaseId: opts.daemonLeaseId
+        });
+        if (repeatedBlockerCount >= 3) {
+          goal = store.updateGoalStatus(goal.goalId, "blocked", { daemonLeaseId: opts.daemonLeaseId });
+          return resultFromGoal(goal, "failed", stdoutFor(goal, store.listGoalPlanNodes(goal.goalId), evidence), blocker2, startedAt);
+        }
+        break;
+      }
+      continue;
+    }
+    if (nodes.every((node) => node.status === "complete")) {
+      const judged = await generateObject({
+        model,
+        schema: AchievementSchema,
+        temperature: 0,
+        prompt: achievementPrompt(goal, nodes, evidence),
+        abortSignal: opts.signal
+      });
+      const tokens = usageTotal(judged.usage);
+      validation = judged.object;
+      const achieved = judged.object.achieved && judged.object.adversarialReview.trim().length > 0;
+      const unmet = achieved ? [] : judged.object.unmetRequirements.length > 0 ? judged.object.unmetRequirements : ["adversarial review did not prove completion"];
+      store.recordGoalEvent({
+        goalId: goal.goalId,
+        turn,
+        phase: "validate",
+        status: achieved ? "complete" : "blocked",
+        tokensUsed: tokens,
+        evidence: {
+          achieved,
+          evidence: judged.object.evidence,
+          unmetRequirements: unmet,
+          adversarialReview: judged.object.adversarialReview
+        },
+        rawResponse: judged.object
+      }, { daemonLeaseId: opts.daemonLeaseId });
+      goal = store.requireGoal(goal.goalId);
+      if (achieved) {
+        goal = store.updateGoalStatus(goal.goalId, "complete", { daemonLeaseId: opts.daemonLeaseId });
+        return resultFromGoal(goal, "succeeded", stdoutFor(goal, nodes, evidence, validation), undefined, startedAt);
+      }
+      const blocker2 = sameBlockerKey(unmet);
+      if (blocker2 === lastBlocker)
+        repeatedBlockerCount += 1;
+      else {
+        lastBlocker = blocker2;
+        repeatedBlockerCount = 1;
+      }
+      if (repeatedBlockerCount >= 3) {
+        goal = store.updateGoalStatus(goal.goalId, "blocked", { daemonLeaseId: opts.daemonLeaseId });
+        return resultFromGoal(goal, "failed", stdoutFor(goal, nodes, evidence, validation), blocker2, startedAt);
+      }
+      continue;
+    }
+    const blocker = "no ready goal nodes and goal plan is incomplete";
+    if (blocker === lastBlocker)
+      repeatedBlockerCount += 1;
+    else {
+      lastBlocker = blocker;
+      repeatedBlockerCount = 1;
+    }
+    store.recordGoalEvent({
+      goalId: goal.goalId,
+      turn,
+      phase: "status",
+      status: repeatedBlockerCount >= 3 ? "blocked" : "active",
+      evidence: { blocker }
+    }, { daemonLeaseId: opts.daemonLeaseId });
+    if (repeatedBlockerCount >= 3) {
+      goal = store.updateGoalStatus(goal.goalId, "blocked", { daemonLeaseId: opts.daemonLeaseId });
+      return resultFromGoal(goal, "failed", stdoutFor(goal, nodes, evidence, validation), blocker, startedAt);
+    }
+  }
+  goal = store.updateGoalStatus(goal.goalId, "usageLimited", { daemonLeaseId: opts.daemonLeaseId });
+  return resultFromGoal(goal, "failed", stdoutFor(goal, store.listGoalPlanNodes(goal.goalId), evidence, validation), "goal max turns exhausted", startedAt);
+}
+
 // src/lib/workflow-runner.ts
 function targetWithStepAccount(step) {
   const account = step.account ?? step.target.account;
@@ -2391,6 +3290,24 @@ function workflowResult(workflowRun, status, startedAt, finishedAt, stdout, erro
   };
 }
 async function executeWorkflow(store, workflow, opts = {}) {
+  if (workflow.goal) {
+    const workflowWithoutGoal = { ...workflow, goal: undefined };
+    return runGoal(store, workflow.goal, {
+      ...opts,
+      context: {
+        loopId: opts.loop?.id,
+        loopName: opts.loop?.name,
+        loopRunId: opts.loopRun?.id,
+        scheduledFor: opts.loopRun?.scheduledFor ?? opts.scheduledFor,
+        workflowId: workflow.id,
+        workflowName: workflow.name
+      },
+      executeNode: async (node) => executeWorkflow(store, workflowWithoutGoal, {
+        ...opts,
+        idempotencyKey: `${opts.idempotencyKey ?? workflow.id}:goal:${node.key}`
+      })
+    });
+  }
   const run = store.createWorkflowRun({
     workflow,
     loop: opts.loop,
@@ -2466,16 +3383,34 @@ async function executeWorkflow(store, workflow, opts = {}) {
     }, opts.cancelPollMs ?? 500);
     cancelTimer.unref();
     try {
-      result = await executeTarget(targetWithStepAccount(step), metadata, {
-        ...opts,
-        machine: opts.machine ?? opts.loop?.machine,
-        signal: controller.signal,
-        onSpawn: (pid) => {
-          opts.beforePersist?.();
-          store.markWorkflowStepPid(run.id, step.id, pid, { daemonLeaseId: opts.daemonLeaseId });
-          opts.onSpawn?.(pid);
-        }
-      });
+      if (step.goal) {
+        result = await runGoal(store, step.goal, {
+          ...opts,
+          target: targetWithStepAccount(step),
+          signal: controller.signal,
+          context: {
+            loopId: opts.loop?.id,
+            loopName: opts.loop?.name,
+            loopRunId: opts.loopRun?.id,
+            scheduledFor: opts.loopRun?.scheduledFor ?? opts.scheduledFor,
+            workflowId: workflow.id,
+            workflowName: workflow.name,
+            workflowRunId: run.id,
+            workflowStepId: step.id
+          }
+        });
+      } else {
+        result = await executeTarget(targetWithStepAccount(step), metadata, {
+          ...opts,
+          machine: opts.machine ?? opts.loop?.machine,
+          signal: controller.signal,
+          onSpawn: (pid) => {
+            opts.beforePersist?.();
+            store.markWorkflowStepPid(run.id, step.id, pid, { daemonLeaseId: opts.daemonLeaseId });
+            opts.onSpawn?.(pid);
+          }
+        });
+      }
     } catch (error) {
       const finishedAt2 = nowIso();
       result = {
@@ -2553,9 +3488,42 @@ function preflightWorkflow(workflow, opts = {}) {
   }, opts));
 }
 async function executeLoopTarget(store, loop, run, opts = {}) {
-  if (loop.target.type !== "workflow")
+  if (loop.target.type !== "workflow") {
+    if (loop.goal) {
+      return runGoal(store, loop.goal, {
+        ...opts,
+        target: loop.target,
+        context: {
+          loopId: loop.id,
+          loopName: loop.name,
+          loopRunId: run.id,
+          scheduledFor: run.scheduledFor
+        }
+      });
+    }
     return executeLoop(loop, run, opts);
+  }
   const workflow = store.requireWorkflow(loop.target.workflowId);
+  if (loop.goal) {
+    return runGoal(store, loop.goal, {
+      ...opts,
+      context: {
+        loopId: loop.id,
+        loopName: loop.name,
+        loopRunId: run.id,
+        scheduledFor: run.scheduledFor,
+        workflowId: workflow.id,
+        workflowName: workflow.name
+      },
+      executeNode: async (node) => executeWorkflow(store, workflow, {
+        ...opts,
+        loop,
+        loopRun: run,
+        scheduledFor: run.scheduledFor,
+        idempotencyKey: `${loop.id}:${run.scheduledFor}:attempt:${run.attempt}:goal:${node.key}`
+      })
+    });
+  }
   const controller = loop.target.timeoutMs ? new AbortController : undefined;
   let workflowTimedOut = false;
   const externalAbort = () => controller?.abort();
@@ -3248,7 +4216,7 @@ function runDoctor(store) {
 
 // src/cli/index.ts
 var program = new Command;
-program.name("loops").description("Persistent local loops for commands and headless coding agents").version("0.3.5");
+program.name("loops").description("Persistent local loops for commands and headless coding agents").version("0.3.6");
 program.option("-j, --json", "print JSON");
 function isJson() {
   return Boolean(program.opts().json);
@@ -3327,6 +4295,7 @@ function baseCreateInput(name, opts, target) {
     description: typeof opts.description === "string" ? opts.description : undefined,
     schedule,
     target,
+    goal: goalFromOpts(opts),
     machine: typeof opts.machine === "string" ? resolveLoopMachine(opts.machine) : undefined,
     ...policy,
     expiresAt: typeof opts.expiresAt === "string" ? new Date(opts.expiresAt).toISOString() : undefined
@@ -3341,6 +4310,23 @@ function addAccountOptions(command) {
 function addMachineOptions(command) {
   return command.option("--machine <id>", "OpenMachines machine id to assign this loop to");
 }
+function addGoalOptions(command) {
+  return command.option("--goal <objective>", "wrap this loop target in an AI-SDK goal objective").option("--goal-budget <tokens>", "maximum goal orchestration token budget").option("--goal-model <model>", "OpenRouter model id for goal planning and validation").option("--goal-max-turns <n>", "maximum goal orchestration turns");
+}
+function goalFromOpts(opts) {
+  const hasGoalOption = opts.goal !== undefined || opts.goalBudget !== undefined || opts.goalModel !== undefined || opts.goalMaxTurns !== undefined;
+  if (!hasGoalOption)
+    return;
+  if (typeof opts.goal !== "string")
+    throw new Error("--goal is required when using goal options");
+  return normalizeGoalSpec({
+    objective: opts.goal,
+    tokenBudget: positiveInteger(typeof opts.goalBudget === "string" ? opts.goalBudget : undefined, "--goal-budget"),
+    model: typeof opts.goalModel === "string" ? opts.goalModel : undefined,
+    maxTurns: positiveInteger(typeof opts.goalMaxTurns === "string" ? opts.goalMaxTurns : undefined, "--goal-max-turns"),
+    autoExecute: "readyOnly"
+  }, "goal");
+}
 function accountFromOpts(opts) {
   if (!opts.account && opts.accountTool)
     throw new Error("--account-tool requires --account");
@@ -3354,7 +4340,7 @@ function providerAuthProfileFromOpts(opts, provider) {
   return opts.authProfile;
 }
 var create = program.command("create").description("create loops");
-addAccountOptions(addMachineOptions(addScheduleOptions(create.command("command <name>").description("create a deterministic shell command loop").requiredOption("--cmd <command>", "command string to execute").option("--cwd <dir>", "working directory").option("--timeout <duration>", "run timeout").option("--no-shell", "execute without a shell")))).action((name, opts) => {
+addGoalOptions(addAccountOptions(addMachineOptions(addScheduleOptions(create.command("command <name>").description("create a deterministic shell command loop").requiredOption("--cmd <command>", "command string to execute").option("--cwd <dir>", "working directory").option("--timeout <duration>", "run timeout").option("--no-shell", "execute without a shell"))))).action((name, opts) => {
   const store = new Store;
   try {
     const target = {
@@ -3371,7 +4357,7 @@ addAccountOptions(addMachineOptions(addScheduleOptions(create.command("command <
     store.close();
   }
 });
-addAccountOptions(addMachineOptions(addScheduleOptions(create.command("agent <name>").description("create a headless coding-agent loop").requiredOption("--provider <provider>", "claude, cursor, codewith, aicopilot, opencode, or codex").requiredOption("--prompt <prompt>", "agent prompt").option("--cwd <dir>", "working directory").option("--model <model>", "model").option("--agent <agent>", "provider-specific agent").option("--auth-profile <profile>", "provider-native auth profile; currently supported for codewith").option("--timeout <duration>", "run timeout").option("--config-isolation <mode>", "safe or none", "safe")))).action((name, opts) => {
+addGoalOptions(addAccountOptions(addMachineOptions(addScheduleOptions(create.command("agent <name>").description("create a headless coding-agent loop").requiredOption("--provider <provider>", "claude, cursor, codewith, aicopilot, opencode, or codex").requiredOption("--prompt <prompt>", "agent prompt").option("--cwd <dir>", "working directory").option("--model <model>", "model").option("--agent <agent>", "provider-specific agent").option("--auth-profile <profile>", "provider-native auth profile; currently supported for codewith").option("--timeout <duration>", "run timeout").option("--config-isolation <mode>", "safe or none", "safe"))))).action((name, opts) => {
   const provider = opts.provider;
   if (!["claude", "cursor", "codewith", "aicopilot", "opencode", "codex"].includes(provider)) {
     throw new Error("unsupported provider");
@@ -3399,7 +4385,7 @@ addAccountOptions(addMachineOptions(addScheduleOptions(create.command("agent <na
     store.close();
   }
 });
-addMachineOptions(addScheduleOptions(create.command("workflow <name>").description("schedule a stored workflow").requiredOption("--workflow <idOrName>", "workflow id or name"))).action((name, opts) => {
+addGoalOptions(addMachineOptions(addScheduleOptions(create.command("workflow <name>").description("schedule a stored workflow").requiredOption("--workflow <idOrName>", "workflow id or name")))).action((name, opts) => {
   const store = new Store;
   try {
     const workflow = store.requireWorkflow(opts.workflow);
@@ -3415,6 +4401,51 @@ addMachineOptions(addScheduleOptions(create.command("workflow <name>").descripti
 });
 var workflows = program.command("workflows").alias("workflow").description("manage workflow specs and runs");
 var machines = program.command("machines").description("inspect OpenMachines topology for loop assignment");
+var goal = program.command("goal").description("inspect goal runs");
+goal.command("show <idOrName>").description("show a goal or configured loop/workflow goal").action((idOrName) => {
+  const store = new Store;
+  try {
+    const runtimeGoal = store.getGoal(idOrName) ?? store.findGoalByLoop(idOrName);
+    if (runtimeGoal) {
+      const value = {
+        goal: publicGoal(runtimeGoal),
+        nodes: store.listGoalPlanNodes(runtimeGoal.goalId),
+        runs: store.listGoalRuns({ goalId: runtimeGoal.goalId }).map(publicGoalRun)
+      };
+      print(value, `${runtimeGoal.goalId} ${runtimeGoal.status} ${runtimeGoal.objective}`);
+      return;
+    }
+    const loop = store.getLoop(idOrName) ?? store.findLoopByName(idOrName);
+    if (loop?.goal) {
+      print({ config: loop.goal, loop: publicLoop(loop) }, `configured goal for loop ${loop.name}: ${loop.goal.objective}`);
+      return;
+    }
+    const workflow = store.getWorkflow(idOrName) ?? store.findWorkflowByName(idOrName);
+    if (workflow?.goal) {
+      print({ config: workflow.goal, workflow: publicWorkflow(workflow) }, `configured goal for workflow ${workflow.name}: ${workflow.goal.objective}`);
+      return;
+    }
+    throw new Error(`goal not found: ${idOrName}`);
+  } finally {
+    store.close();
+  }
+});
+goal.command("status <runId>").description("show goal status for a goal, goal event, loop run, or workflow run").action((runId) => {
+  const store = new Store;
+  try {
+    const runtimeGoal = store.findGoalByRunId(runId);
+    if (!runtimeGoal)
+      throw new Error(`goal run not found: ${runId}`);
+    const value = {
+      goal: publicGoal(runtimeGoal),
+      nodes: store.listGoalPlanNodes(runtimeGoal.goalId),
+      runs: store.listGoalRuns({ goalId: runtimeGoal.goalId }).map(publicGoalRun)
+    };
+    print(value, `${runtimeGoal.goalId} ${runtimeGoal.status} tokens=${runtimeGoal.tokensUsed}`);
+  } finally {
+    store.close();
+  }
+});
 machines.command("list").alias("ls").description("list known machines").action(() => {
   const values = listOpenMachines();
   if (isJson())
@@ -3438,6 +4469,7 @@ workflows.command("validate <file>").description("validate a workflow JSON file
     description: body.description,
     version: body.version ?? 1,
     status: "active",
+    goal: body.goal,
     steps: body.steps,
     createdAt: now,
     updatedAt: now