pulseed 0.6.0 → 0.6.2

package/dist/orchestrator/loop/durable-loop/task-cycle-wait.js

@@ -0,0 +1,176 @@
+import * as path from "node:path";
+import { ApprovalStore } from "../../../runtime/store/approval-store.js";
+import { syncWaitStrategyScheduleProjection } from "../../../runtime/schedule/wait-projection.js";
+import { buildWaitApprovalId } from "../../strategy/portfolio-rebalance.js";
+import { buildWaitObservationActivationContext } from "./task-cycle-stall.js";
+const WAIT_APPROVAL_TIMEOUT_MS = 24 * 60 * 60 * 1000;
+const WAIT_APPROVAL_REMINDER_MS = 15 * 60 * 1000;
+export async function evaluateWaitStrategiesForObserveOnly(ctx, goalId, goal, result, preferredWaitStrategyId) {
+    if (!ctx.deps.portfolioManager) {
+        return { observeOnly: false, newGenerationNeeded: false, outcome: null };
+    }
+    const waitActivationContext = buildWaitObservationActivationContext(ctx, goalId, goal, await ctx.deps.stateManager.loadGapHistory(goalId));
+    try {
+        const portfolio = await ctx.deps.strategyManager.getPortfolio(goalId);
+        if (!portfolio) {
+            return { observeOnly: false, newGenerationNeeded: false, outcome: null };
+        }
+        let firstNotDue = null;
+        const prioritizedStrategies = [
+            ...portfolio.strategies.filter((strategy) => strategy.id === preferredWaitStrategyId),
+            ...portfolio.strategies.filter((strategy) => strategy.id !== preferredWaitStrategyId),
+        ];
+        for (const strategy of prioritizedStrategies) {
+            if (strategy.state !== "active" || !ctx.deps.portfolioManager.isWaitStrategy(strategy)) {
+                continue;
+            }
+            const waitOutcome = await ctx.deps.portfolioManager.handleWaitStrategyExpiry(goalId, strategy.id, waitActivationContext);
+            if (!waitOutcome) {
+                continue;
+            }
+            if (waitOutcome.status === "not_due") {
+                firstNotDue ??= { strategyId: strategy.id, outcome: waitOutcome };
+                continue;
+            }
+            result.waitStrategyId = strategy.id;
+            result.waitExpiryOutcome = waitOutcome;
+            result.waitObserveOnly = true;
+            result.waitExpired = true;
+            if (waitOutcome.status === "approval_required") {
+                result.waitApprovalId = await persistWaitApprovalPending(ctx, goalId, strategy, waitOutcome);
+            }
+            const waitTrigger = waitOutcome.rebalance_trigger ?? null;
+            if (waitTrigger) {
+                const rebalanceResult = await ctx.deps.portfolioManager.rebalance(goalId, waitTrigger);
+                if (rebalanceResult.new_generation_needed) {
+                    await ctx.deps.strategyManager.onStallDetected(goalId, 3, goal.origin ?? "general", waitActivationContext);
+                    result.waitObserveOnly = false;
+                    return { observeOnly: false, newGenerationNeeded: true, outcome: waitOutcome };
+                }
+            }
+            return { observeOnly: true, newGenerationNeeded: false, outcome: waitOutcome };
+        }
+        if (firstNotDue) {
+            result.waitStrategyId = firstNotDue.strategyId;
+            result.waitExpiryOutcome = firstNotDue.outcome;
+            result.waitObserveOnly = true;
+            result.waitSuppressed = true;
+            return { observeOnly: true, newGenerationNeeded: false, outcome: firstNotDue.outcome };
+        }
+    }
+    catch (err) {
+        ctx.logger?.warn("CoreLoop: wait observation failed (non-fatal)", {
+            goalId,
+            error: err instanceof Error ? err.message : String(err),
+        });
+    }
+    return { observeOnly: false, newGenerationNeeded: false, outcome: null };
+}
+async function persistWaitApprovalPending(ctx, goalId, strategy, outcome) {
+    const strategyId = strategy.id;
+    try {
+        const now = Date.now();
+        const approvalId = buildWaitApprovalId(goalId, strategyId);
+        const timeoutMs = WAIT_APPROVAL_TIMEOUT_MS;
+        const nextObserveAt = new Date(now + WAIT_APPROVAL_REMINDER_MS).toISOString();
+        const expiresAt = new Date(now + timeoutMs).toISOString();
+        const task = {
+            id: `wait:${strategyId}`,
+            description: outcome.details ?? "WaitStrategy requires approval before continuing",
+            action: "wait_strategy_resume_approval",
+        };
+        if (ctx.deps.waitApprovalBroker) {
+            void ctx.deps.waitApprovalBroker.requestApproval(goalId, task, timeoutMs, approvalId).catch((err) => {
+                ctx.logger?.warn("CoreLoop: wait approval broker request failed", {
+                    goalId,
+                    strategyId,
+                    error: err instanceof Error ? err.message : String(err),
+                });
+            });
+            await postponeWaitObservationForApproval(ctx, goalId, strategy, approvalId, nextObserveAt, expiresAt);
+            return approvalId;
+        }
+        const baseDir = typeof ctx.deps.stateManager.getBaseDir === "function"
+            ? ctx.deps.stateManager.getBaseDir()
+            : null;
+        if (!baseDir)
+            return undefined;
+        const approvalStore = new ApprovalStore(path.join(baseDir, "runtime"));
+        await approvalStore.savePending({
+            approval_id: approvalId,
+            goal_id: goalId,
+            request_envelope_id: approvalId,
+            correlation_id: approvalId,
+            state: "pending",
+            created_at: now,
+            expires_at: now + timeoutMs,
+            payload: {
+                task,
+                wait_strategy_id: strategyId,
+                wait_outcome: outcome,
+            },
+        });
+        await postponeWaitObservationForApproval(ctx, goalId, strategy, approvalId, nextObserveAt, expiresAt);
+        return approvalId;
+    }
+    catch (err) {
+        ctx.logger?.warn("CoreLoop: failed to persist wait approval request", {
+            goalId,
+            strategyId,
+            error: err instanceof Error ? err.message : String(err),
+        });
+        return undefined;
+    }
+}
+async function postponeWaitObservationForApproval(ctx, goalId, strategy, approvalId, nextObserveAt, expiresAt) {
+    try {
+        const metadataPath = `strategies/${goalId}/wait-meta/${strategy.id}.json`;
+        const raw = await ctx.deps.stateManager.readRaw(metadataPath);
+        const metadata = raw && typeof raw === "object" ? raw : {};
+        const waitUntil = typeof metadata["wait_until"] === "string"
+            ? metadata["wait_until"]
+            : typeof strategy.wait_until === "string"
+                ? strategy.wait_until
+                : nextObserveAt;
+        const conditions = Array.isArray(metadata["conditions"]) && metadata["conditions"].length > 0
+            ? metadata["conditions"]
+            : [{ type: "time_until", until: waitUntil }];
+        await ctx.deps.stateManager.writeRaw(metadataPath, {
+            ...metadata,
+            schema_version: 1,
+            wait_until: waitUntil,
+            conditions,
+            resume_plan: metadata["resume_plan"] ?? { action: "complete_wait" },
+            next_observe_at: nextObserveAt,
+            latest_observation: {
+                status: "pending",
+                evidence: {
+                    approval_pending: true,
+                    approval_id: approvalId,
+                },
+                next_observe_at: nextObserveAt,
+                confidence: 1,
+                resume_hint: "waiting_for_approval",
+            },
+            approval_pending: {
+                approval_id: approvalId,
+                requested_at: new Date().toISOString(),
+                next_reminder_at: nextObserveAt,
+                expires_at: expiresAt,
+            },
+        });
+        await syncWaitStrategyScheduleProjection({
+            baseDir: ctx.deps.stateManager.getBaseDir(),
+            goalId,
+            strategyId: strategy.id,
+        }).catch(() => undefined);
+    }
+    catch (err) {
+        ctx.logger?.warn("CoreLoop: failed to postpone wait observation for approval", {
+            goalId,
+            strategyId: strategy.id,
+            error: err instanceof Error ? err.message : String(err),
+        });
+    }
+}
+//# sourceMappingURL=task-cycle-wait.js.map

package/dist/orchestrator/loop/durable-loop/task-cycle-wait.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-cycle-wait.js","sourceRoot":"","sources":["../../../../src/orchestrator/loop/durable-loop/task-cycle-wait.ts"],"names":[],"mappings":"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"}

package/dist/orchestrator/loop/durable-loop/task-cycle.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Completion checks and task execution for a CoreLoop iteration.
+ */
+import type { Goal } from "../../../base/types/goal.js";
+import type { GapVector } from "../../../base/types/gap.js";
+import type { DriveScore } from "../../../base/types/drive.js";
+import { type LoopIterationResult } from "./contracts.js";
+import type { PhaseCtx } from "./preparation.js";
+import type { CapabilityAcquisitionOutcome } from "./capability.js";
+import type { CoreLoopEvidenceLedger } from "./evidence-ledger.js";
+import type { ExecutionModeState } from "../../../platform/time/execution-mode.js";
+export { detectStallsAndRebalance } from "./task-cycle-stall.js";
+export { evaluateWaitStrategiesForObserveOnly, type WaitStrategyObservationDecision, } from "./task-cycle-wait.js";
+/** Completion check + milestone deadline check.
+ * Sets result.error on fatal failure, sets result.completionJudgment. */
+export declare function checkCompletionAndMilestones(ctx: PhaseCtx, goalId: string, goal: Goal, result: LoopIterationResult, startTime: number): Promise<void>;
+/** Check dependency graph block.
+ * Returns true if goal is blocked (result.error set, caller should return). */
+export declare function checkDependencyBlock(ctx: PhaseCtx, goalId: string, result: LoopIterationResult): boolean;
+/** Callbacks passed to runTaskCycleWithContext to keep mutable state and side-effects on CoreLoop. */
+export interface LoopCallbacks {
+    handleCapabilityAcquisition: (task: unknown, goalId: string, adapter: unknown) => Promise<CapabilityAcquisitionOutcome | void>;
+    incrementTransferCounter: () => number;
+    tryGenerateReport: (goalId: string, loopIndex: number, result: LoopIterationResult, goal: Goal) => void;
+}
+export interface TaskGenerationHints {
+    targetDimensionOverride?: string;
+    knowledgeContextPrefix?: string;
+    budgetContext?: Record<string, unknown>;
+    executionMode?: ExecutionModeState;
+    runControlRecommendationContext?: string;
+}
+export interface StallActionHints {
+    recommendedAction?: "continue" | "refine" | "pivot";
+}
+/** Collect context, run task cycle, handle capability acquisition,
+ * transfer detection, and post-task completion re-check.
+ * Returns true on success, false if the caller should return result early.
+ * `transferCheckCounter` is incremented via the callback to keep mutable state on CoreLoop. */
+export declare function runTaskCycleWithContext(ctx: PhaseCtx, goalId: string, goal: Goal, gapVector: GapVector, driveScores: DriveScore[], highDissatisfactionDimensions: string[], loopIndex: number, result: LoopIterationResult, startTime: number, callbacks: LoopCallbacks, evidenceLedger?: CoreLoopEvidenceLedger, taskGenerationHints?: TaskGenerationHints): Promise<boolean>;
+//# sourceMappingURL=task-cycle.d.ts.map

package/dist/orchestrator/loop/durable-loop/task-cycle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-cycle.d.ts","sourceRoot":"","sources":["../../../../src/orchestrator/loop/durable-loop/task-cycle.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,6BAA6B,CAAC;AACxD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAC;AAC5D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,8BAA8B,CAAC;AAG/D,OAAO,EAEL,KAAK,mBAAmB,EACzB,MAAM,gBAAgB,CAAC;AACxB,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAejD,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,iBAAiB,CAAC;AACpE,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AACnE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,0CAA0C,CAAC;AACnF,OAAO,EAAE,wBAAwB,EAAE,MAAM,uBAAuB,CAAC;AACjE,OAAO,EACL,oCAAoC,EACpC,KAAK,+BAA+B,GACrC,MAAM,sBAAsB,CAAC;AAI9B;yEACyE;AACzE,wBAAsB,4BAA4B,CAChD,GAAG,EAAE,QAAQ,EACb,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,IAAI,EACV,MAAM,EAAE,mBAAmB,EAC3B,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,IAAI,CAAC,CAuEf;AAID;+EAC+E;AAC/E,wBAAgB,oBAAoB,CAClC,GAAG,EAAE,QAAQ,EACb,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,mBAAmB,GAC1B,OAAO,CAaT;AAID,sGAAsG;AACtG,MAAM,WAAW,aAAa;IAC5B,2BAA2B,EAAE,CAAC,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,KAAK,OAAO,CAAC,4BAA4B,GAAG,IAAI,CAAC,CAAC;IAC/H,wBAAwB,EAAE,MAAM,MAAM,CAAC;IACvC,iBAAiB,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,mBAAmB,EAAE,IAAI,EAAE,IAAI,KAAK,IAAI,CAAC;CACzG;AAED,MAAM,WAAW,mBAAmB;IAClC,uBAAuB,CAAC,EAAE,MAAM,CAAC;IACjC,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACxC,aAAa,CAAC,EAAE,kBAAkB,CAAC;IACnC,+BAA+B,CAAC,EAAE,MAAM,CAAC;CAC1C;AAED,MAAM,WAAW,gBAAgB;IAC/B,iBAAiB,CAAC,EAAE,UAAU,GAAG,QAAQ,GAAG,OAAO,CAAC;CACrD;AAED;;;+FAG+F;AAC/F,wBAAsB,uBAAuB,CAC3C,GAAG,EAAE,QAAQ,EACb,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,IAAI,EACV,SAAS,EAAE,SAAS,EACpB,WAAW,EAAE,UAAU,EAAE,EACzB,6BAA6B,EAAE,MAAM,EAAE,EACvC,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,mBAAmB,EAC3B,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,aAAa,EACxB,cAAc,CAAC,EAAE,sBAAsB,EACvC,mBAAmB,CAAC,EAAE,mBAAmB,GACxC,OAAO,CAAC,OAAO,CAAC,CAyXlB"}