pulseed 0.4.0 → 0.4.2

package/dist/orchestrator/loop/core-loop/learning.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Learning and transfer state that spans CoreLoop iterations.
+ */
+import type { Logger } from "../../../runtime/logger.js";
+import type { CoreLoopDeps } from "./contracts.js";
+import type { ToolExecutor } from "../../../tools/executor.js";
+export declare class CoreLoopLearning {
+    private lastLearningReviewAt;
+    private transferCheckCounter;
+    /** Tracks consecutive capability acquisition failures per capability name */
+    private capabilityAcquisitionFailures;
+    getCapabilityFailures(): Map<string, number>;
+    incrementTransferCounter(): number;
+    /**
+     * Returns the periodic learning review interval in milliseconds based on
+     * how much time remains until the goal's target_date.
+     */
+    getPeriodicReviewInterval(goalId: string, stateManager: CoreLoopDeps["stateManager"]): Promise<number>;
+    /**
+     * Checks whether it is time to run a periodic learning review and, if so,
+     * calls learningPipeline.onPeriodicReview(). Non-fatal — errors are logged
+     * but do not bubble up.
+     */
+    checkPeriodicReview(goalId: string, deps: CoreLoopDeps, logger: Logger | undefined, toolExecutor?: ToolExecutor): Promise<void>;
+    /**
+     * Called after the run loop completes with finalStatus === "completed".
+     * Triggers learningPipeline.onGoalCompleted(). Non-fatal.
+     */
+    onGoalCompleted(goalId: string, deps: CoreLoopDeps, logger: Logger | undefined, toolExecutor?: ToolExecutor): Promise<void>;
+}
+//# sourceMappingURL=learning.d.ts.map

package/dist/orchestrator/loop/core-loop/learning.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"learning.d.ts","sourceRoot":"","sources":["../../../../src/orchestrator/loop/core-loop/learning.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,4BAA4B,CAAC;AACzD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAG/D,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,oBAAoB,CAAsB;IAClD,OAAO,CAAC,oBAAoB,CAAa;IACzC,6EAA6E;IAC7E,OAAO,CAAC,6BAA6B,CAAkC;IAEvE,qBAAqB,IAAI,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC;IAI5C,wBAAwB,IAAI,MAAM;IAIlC;;;OAGG;IACG,yBAAyB,CAC7B,MAAM,EAAE,MAAM,EACd,YAAY,EAAE,YAAY,CAAC,cAAc,CAAC,GACzC,OAAO,CAAC,MAAM,CAAC;IAYlB;;;;OAIG;IACG,mBAAmB,CACvB,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,YAAY,EAClB,MAAM,EAAE,MAAM,GAAG,SAAS,EAC1B,YAAY,CAAC,EAAE,YAAY,GAC1B,OAAO,CAAC,IAAI,CAAC;IA2BhB;;;OAGG;IACG,eAAe,CACnB,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,YAAY,EAClB,MAAM,EAAE,MAAM,GAAG,SAAS,EAC1B,YAAY,CAAC,EAAE,YAAY,GAC1B,OAAO,CAAC,IAAI,CAAC;CAsBjB"}

package/dist/orchestrator/loop/core-loop/learning.js

@@ -0,0 +1,92 @@
+/**
+ * Learning and transfer state that spans CoreLoop iterations.
+ */
+import { gatherLearningEvidence } from "../learning-evidence.js";
+export class CoreLoopLearning {
+    lastLearningReviewAt = Date.now();
+    transferCheckCounter = 0;
+    /** Tracks consecutive capability acquisition failures per capability name */
+    capabilityAcquisitionFailures = new Map();
+    getCapabilityFailures() {
+        return this.capabilityAcquisitionFailures;
+    }
+    incrementTransferCounter() {
+        return ++this.transferCheckCounter;
+    }
+    /**
+     * Returns the periodic learning review interval in milliseconds based on
+     * how much time remains until the goal's target_date.
+     */
+    async getPeriodicReviewInterval(goalId, stateManager) {
+        const goal = await stateManager.loadGoal(goalId);
+        if (!goal?.target_date) {
+            return 72 * 3600 * 1000; // default: 72 hours
+        }
+        const remainingDays = (new Date(goal.target_date).getTime() - Date.now()) / (1000 * 60 * 60 * 24);
+        if (remainingDays <= 30)
+            return 72 * 3600 * 1000; // 短期: 72h
+        if (remainingDays <= 180)
+            return 168 * 3600 * 1000; // 中期: 1week
+        return 336 * 3600 * 1000; // 長期: 2weeks
+    }
+    /**
+     * Checks whether it is time to run a periodic learning review and, if so,
+     * calls learningPipeline.onPeriodicReview(). Non-fatal — errors are logged
+     * but do not bubble up.
+     */
+    async checkPeriodicReview(goalId, deps, logger, toolExecutor) {
+        if (!deps.learningPipeline)
+            return;
+        const now = Date.now();
+        const intervalMs = await this.getPeriodicReviewInterval(goalId, deps.stateManager);
+        if (now - this.lastLearningReviewAt >= intervalMs) {
+            try {
+                if (toolExecutor) {
+                    const toolCtx = { cwd: ".", goalId, trustBalance: 0, preApproved: true, approvalFn: async () => false };
+                    const evidence = await gatherLearningEvidence(toolExecutor, toolCtx);
+                    if (evidence.errors.length > 0) {
+                        logger?.warn("CoreLoop: evidence gathering errors", { goalId, errors: evidence.errors });
+                    }
+                    logger?.debug("CoreLoop: periodic review evidence", { goalId, artifactCount: evidence.artifactCount, changesLen: evidence.recentChanges.length });
+                }
+                await deps.learningPipeline.onPeriodicReview(goalId);
+                this.lastLearningReviewAt = now;
+            }
+            catch (err) {
+                // non-fatal: learning pipeline failure should not block main loop
+                logger?.warn("CoreLoop: learningPipeline.onPeriodicReview failed", {
+                    goalId,
+                    error: err instanceof Error ? err.message : String(err),
+                });
+            }
+        }
+    }
+    /**
+     * Called after the run loop completes with finalStatus === "completed".
+     * Triggers learningPipeline.onGoalCompleted(). Non-fatal.
+     */
+    async onGoalCompleted(goalId, deps, logger, toolExecutor) {
+        if (!deps.learningPipeline)
+            return;
+        try {
+            if (toolExecutor) {
+                const toolCtx = { cwd: ".", goalId, trustBalance: 0, preApproved: true, approvalFn: async () => false };
+                const evidence = await gatherLearningEvidence(toolExecutor, toolCtx);
+                if (evidence.errors.length > 0) {
+                    logger?.warn("CoreLoop: evidence gathering errors", { goalId, errors: evidence.errors });
+                }
+                // Evidence is informational — log artifact count for observability
+                logger?.debug("CoreLoop: goal completed evidence", { goalId, artifactCount: evidence.artifactCount });
+            }
+            await deps.learningPipeline.onGoalCompleted(goalId);
+        }
+        catch (err) {
+            // non-fatal
+            logger?.warn("CoreLoop: learningPipeline.onGoalCompleted failed", {
+                goalId,
+                error: err instanceof Error ? err.message : String(err),
+            });
+        }
+    }
+}
+//# sourceMappingURL=learning.js.map

package/dist/orchestrator/loop/core-loop/learning.js.map

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

package/dist/orchestrator/loop/core-loop/preparation.d.ts

@@ -0,0 +1,63 @@
+/**
+ * Preparation and scoring steps for a single CoreLoop iteration.
+ */
+import type { Logger } from "../../../runtime/logger.js";
+import type { ToolExecutor } from "../../../tools/executor.js";
+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 CoreLoopDeps, type ResolvedLoopConfig, type LoopIterationResult } from "./contracts.js";
+/** Minimal context passed to every phase function. */
+export interface PhaseCtx {
+    deps: CoreLoopDeps;
+    config: ResolvedLoopConfig;
+    logger: Logger | undefined;
+    toolExecutor?: ToolExecutor;
+    /**
+     * Optional TimeHorizonEngine for canAffordWait gate in rebalancePortfolio (Gap 1).
+     * When present, WaitStrategy processing is skipped if the engine reports the goal
+     * cannot afford to wait given the remaining time budget.
+     */
+    timeHorizonEngine?: import("../../../platform/time/time-horizon-engine.js").ITimeHorizonEngine;
+}
+/** Load goal from state, apply tree aggregation if applicable.
+ * Returns the loaded Goal, or null if an error occurred (result is mutated). */
+export declare function loadGoalWithAggregation(ctx: PhaseCtx, goalId: string, result: LoopIterationResult, startTime: number): Promise<Goal | null>;
+/**
+ * Automatically decompose an abstract goal into sub-goals using
+ * TreeLoopOrchestrator.ensureGoalRefined(). Skipped when disabled,
+ * when the goal already has children, or when the goal is a leaf.
+ * Only root goals (decomposition_depth === 0) are auto-decomposed to
+ * prevent recursive decomposition of child nodes.
+ * Specificity checks are delegated to ensureGoalRefined internally.
+ *
+ * @param decomposedGoals - Set of goal IDs already decomposed this run.
+ *   When provided, goals already in the set are skipped and the goal ID is
+ *   added to the set after a successful decomposition attempt.
+ */
+export declare function phaseAutoDecompose(goalId: string, goal: Goal, deps: CoreLoopDeps, config: ResolvedLoopConfig, logger: Logger | undefined, decomposedGoals?: Set<string>, isFirstIteration?: boolean): Promise<void>;
+/** Build a ToolCallContext from PhaseCtx for CoreLoop autonomous tool calls. */
+export declare function buildLoopToolContext(ctx: PhaseCtx, goalId: string): Promise<import("../../../tools/types.js").ToolCallContext>;
+/** Run observation engine, reload goal after observation.
+ * Observation failure is non-fatal — returns current goal state.
+ * When ctx.toolExecutor is present, routes through the observe-goal tool first
+ * and falls back to direct engine.observe() on tool failure. */
+export declare function observeAndReload(ctx: PhaseCtx, goalId: string, goal: Goal, loopIndex: number): Promise<Goal>;
+/** Calculate gap vector and aggregate.
+ * Returns null on error.
+ * When gap === 0, returns the gap result with skipTaskGeneration=true so the
+ * caller continues to Phase 5 (SatisficingJudge) instead of short-circuiting.
+ */
+export declare function calculateGapOrComplete(ctx: PhaseCtx, goalId: string, goal: Goal, loopIndex: number, result: LoopIterationResult, startTime: number): Promise<{
+    gapVector: GapVector;
+    gapAggregate: number;
+    skipTaskGeneration?: boolean;
+} | null>;
+/** Score drives, update DriveScoreAdapter, check knowledge gap.
+ * Returns ranked DriveScores with highDissatisfactionDimensions, or null if the caller should
+ * return result early (knowledge gap task generated or drive scoring failed). */
+export declare function scoreDrivesAndCheckKnowledge(ctx: PhaseCtx, goalId: string, goal: Goal, gapVector: GapVector, loopIndex: number, result: LoopIterationResult, startTime: number, tryGenerateReport: (goalId: string, loopIndex: number, result: LoopIterationResult, goal: Goal) => void): Promise<{
+    driveScores: DriveScore[];
+    highDissatisfactionDimensions: string[];
+} | null>;
+//# sourceMappingURL=preparation.d.ts.map

package/dist/orchestrator/loop/core-loop/preparation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"preparation.d.ts","sourceRoot":"","sources":["../../../../src/orchestrator/loop/core-loop/preparation.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,4BAA4B,CAAC;AACzD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC/D,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;AAC/D,OAAO,EAEL,KAAK,YAAY,EACjB,KAAK,kBAAkB,EACvB,KAAK,mBAAmB,EACzB,MAAM,gBAAgB,CAAC;AAGxB,sDAAsD;AACtD,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,YAAY,CAAC;IACnB,MAAM,EAAE,kBAAkB,CAAC;IAC3B,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B;;;;OAIG;IACH,iBAAiB,CAAC,EAAE,OAAO,+CAA+C,EAAE,kBAAkB,CAAC;CAChG;AAID;gFACgF;AAChF,wBAAsB,uBAAuB,CAC3C,GAAG,EAAE,QAAQ,EACb,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,mBAAmB,EAC3B,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,IAAI,GAAG,IAAI,CAAC,CA6BtB;AAID;;;;;;;;;;;GAWG;AACH,wBAAsB,kBAAkB,CACtC,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,IAAI,EACV,IAAI,EAAE,YAAY,EAClB,MAAM,EAAE,kBAAkB,EAC1B,MAAM,EAAE,MAAM,GAAG,SAAS,EAC1B,eAAe,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,EAC7B,gBAAgB,CAAC,EAAE,OAAO,GACzB,OAAO,CAAC,IAAI,CAAC,CA4Cf;AAID,gFAAgF;AAChF,wBAAsB,oBAAoB,CACxC,GAAG,EAAE,QAAQ,EACb,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,OAAO,yBAAyB,EAAE,eAAe,CAAC,CAiB5D;AAID;;;gEAGgE;AAChE,wBAAsB,gBAAgB,CACpC,GAAG,EAAE,QAAQ,EACb,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,IAAI,EACV,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,IAAI,CAAC,CAuCf;AAID;;;;GAIG;AACH,wBAAsB,sBAAsB,CAC1C,GAAG,EAAE,QAAQ,EACb,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,IAAI,EACV,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,mBAAmB,EAC3B,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC;IAAE,SAAS,EAAE,SAAS,CAAC;IAAC,YAAY,EAAE,MAAM,CAAC;IAAC,kBAAkB,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,IAAI,CAAC,CAyF9F;AAID;;iFAEiF;AACjF,wBAAsB,4BAA4B,CAChD,GAAG,EAAE,QAAQ,EACb,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,IAAI,EACV,SAAS,EAAE,SAAS,EACpB,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,mBAAmB,EAC3B,SAAS,EAAE,MAAM,EACjB,iBAAiB,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,mBAAmB,EAAE,IAAI,EAAE,IAAI,KAAK,IAAI,GACtG,OAAO,CAAC;IAAE,WAAW,EAAE,UAAU,EAAE,CAAC;IAAC,6BAA6B,EAAE,MAAM,EAAE,CAAA;CAAE,GAAG,IAAI,CAAC,CAoHxF"}

package/dist/orchestrator/loop/core-loop/preparation.js

@@ -0,0 +1,362 @@
+/**
+ * Preparation and scoring steps for a single CoreLoop iteration.
+ */
+import { buildDriveContext, } from "./contracts.js";
+import { logRewardComputation } from "../../../platform/drive/reward-log.js";
+// ─── Phase 1 ───
+/** Load goal from state, apply tree aggregation if applicable.
+ * Returns the loaded Goal, or null if an error occurred (result is mutated). */
+export async function loadGoalWithAggregation(ctx, goalId, result, startTime) {
+    let goal;
+    try {
+        const loaded = await ctx.deps.stateManager.loadGoal(goalId);
+        if (!loaded) {
+            result.error = `Goal "${goalId}" not found`;
+            result.elapsedMs = Date.now() - startTime;
+            return null;
+        }
+        goal = loaded;
+    }
+    catch (err) {
+        result.error = `Failed to load goal: ${err instanceof Error ? err.message : String(err)}`;
+        ctx.logger?.error(`CoreLoop: ${result.error}`, { goalId });
+        result.elapsedMs = Date.now() - startTime;
+        return null;
+    }
+    // Tree aggregation
+    if (ctx.deps.stateAggregator && goal.children_ids.length > 0) {
+        try {
+            await ctx.deps.stateAggregator.aggregateChildStates(goalId);
+            const reloaded = await ctx.deps.stateManager.loadGoal(goalId);
+            if (reloaded)
+                goal = reloaded;
+        }
+        catch {
+            // Tree aggregation failure is non-fatal
+        }
+    }
+    return goal;
+}
+// ─── Phase 1b: Auto-decompose ───
+/**
+ * Automatically decompose an abstract goal into sub-goals using
+ * TreeLoopOrchestrator.ensureGoalRefined(). Skipped when disabled,
+ * when the goal already has children, or when the goal is a leaf.
+ * Only root goals (decomposition_depth === 0) are auto-decomposed to
+ * prevent recursive decomposition of child nodes.
+ * Specificity checks are delegated to ensureGoalRefined internally.
+ *
+ * @param decomposedGoals - Set of goal IDs already decomposed this run.
+ *   When provided, goals already in the set are skipped and the goal ID is
+ *   added to the set after a successful decomposition attempt.
+ */
+export async function phaseAutoDecompose(goalId, goal, deps, config, logger, decomposedGoals, isFirstIteration) {
+    if (config.autoDecompose === false)
+        return;
+    if (!deps.treeLoopOrchestrator)
+        return;
+    if (goal.children_ids.length > 0) {
+        logger?.debug("[CoreLoop] phaseAutoDecompose: skipped — goal already has children", { goalId });
+        return;
+    }
+    if (goal.node_type === "leaf") {
+        logger?.debug("[CoreLoop] phaseAutoDecompose: skipped — goal is leaf", { goalId });
+        return;
+    }
+    // Only auto-decompose root goals — prevent recursive decomposition of children
+    if ((goal.decomposition_depth ?? 0) > 0) {
+        logger?.debug("[CoreLoop] phaseAutoDecompose: skipped — non-root goal (depth > 0)", { goalId, depth: goal.decomposition_depth });
+        return;
+    }
+    // Skip if already decomposed this run
+    if (decomposedGoals?.has(goalId)) {
+        logger?.debug("[CoreLoop] phaseAutoDecompose: skipped — already decomposed this run", { goalId });
+        return;
+    }
+    const force = isFirstIteration === true;
+    if (force) {
+        logger?.info("[decompose] forcing goal decomposition on first iteration", { goalId });
+    }
+    else {
+        logger?.info("[CoreLoop] phaseAutoDecompose: decomposing abstract goal", { goalId });
+    }
+    decomposedGoals?.add(goalId);
+    try {
+        await deps.treeLoopOrchestrator.ensureGoalRefined(goalId, { force });
+    }
+    catch (err) {
+        logger?.warn("[CoreLoop] phaseAutoDecompose: ensureGoalRefined failed (non-fatal)", {
+            goalId,
+            error: err instanceof Error ? err.message : String(err),
+        });
+        return;
+    }
+    logger?.info("[CoreLoop] phaseAutoDecompose: decomposition complete", { goalId });
+}
+// ─── Phase 2 helpers ───
+/** Build a ToolCallContext from PhaseCtx for CoreLoop autonomous tool calls. */
+export async function buildLoopToolContext(ctx, goalId) {
+    let trustBalance = 0;
+    if (ctx.deps.trustManager) {
+        try {
+            const balance = await ctx.deps.trustManager.getBalance(goalId);
+            trustBalance = balance.balance;
+        }
+        catch {
+            // Non-fatal — default to 0
+        }
+    }
+    return {
+        cwd: process.cwd(),
+        goalId,
+        trustBalance,
+        preApproved: true,
+        approvalFn: async () => false,
+    };
+}
+// ─── Phase 2 ───
+/** Run observation engine, reload goal after observation.
+ * Observation failure is non-fatal — returns current goal state.
+ * When ctx.toolExecutor is present, routes through the observe-goal tool first
+ * and falls back to direct engine.observe() on tool failure. */
+export async function observeAndReload(ctx, goalId, goal, loopIndex) {
+    ctx.deps.onProgress?.({
+        iteration: loopIndex + 1,
+        maxIterations: ctx.config.maxIterations,
+        phase: "Observing...",
+    });
+    // Tool path: route through ToolExecutor when available
+    if (ctx.toolExecutor) {
+        try {
+            const toolCtx = await buildLoopToolContext(ctx, goalId);
+            const toolResult = await ctx.toolExecutor.execute("observe-goal", { goal_id: goalId }, toolCtx);
+            if (toolResult.success) {
+                const reloaded = await ctx.deps.stateManager.loadGoal(goalId);
+                if (reloaded)
+                    return reloaded;
+                return goal;
+            }
+            ctx.logger?.warn(`CoreLoop: observe-goal tool failed: ${toolResult.error}, falling back to direct call`);
+        }
+        catch (err) {
+            ctx.logger?.warn("CoreLoop: observe-goal tool threw (falling back to direct call)", { error: err instanceof Error ? err.message : String(err) });
+        }
+    }
+    // Direct path: fallback (or when toolExecutor is absent)
+    try {
+        const engine = ctx.deps.observationEngine;
+        ctx.logger?.debug("CoreLoop: engine.getDataSources exists", { exists: true });
+        const dataSources = engine.getDataSources();
+        ctx.logger?.debug("CoreLoop: observation setup", { dataSourceCount: dataSources.length });
+        await engine.observe(goalId, []);
+        const reloaded = await ctx.deps.stateManager.loadGoal(goalId);
+        if (reloaded)
+            return reloaded;
+    }
+    catch (err) {
+        ctx.logger?.warn("CoreLoop: observation failed (non-fatal)", { error: err instanceof Error ? err.message : String(err) });
+    }
+    return goal;
+}
+// ─── Phase 3 ───
+/** Calculate gap vector and aggregate.
+ * Returns null on error.
+ * When gap === 0, returns the gap result with skipTaskGeneration=true so the
+ * caller continues to Phase 5 (SatisficingJudge) instead of short-circuiting.
+ */
+export async function calculateGapOrComplete(ctx, goalId, goal, loopIndex, result, startTime) {
+    let gapVector;
+    let gapAggregate;
+    try {
+        // Refresh stale dimensions via tool measurement before gap calculation
+        if (ctx.toolExecutor && goal.dimensions) {
+            const { needsDirectMeasurement, measureDirectly } = await import("../../../platform/drive/gap-calculator-tools.js");
+            let anyRefreshed = false;
+            for (const dim of goal.dimensions) {
+                if (needsDirectMeasurement(dim)) {
+                    try {
+                        const refreshed = await measureDirectly(dim, ctx.toolExecutor, {
+                            cwd: process.cwd(),
+                            goalId,
+                            trustBalance: 0,
+                            preApproved: true,
+                            approvalFn: async () => false,
+                        });
+                        if (refreshed !== null) {
+                            dim.current_value = refreshed.value;
+                            dim.confidence = refreshed.confidence;
+                            anyRefreshed = true;
+                            ctx.logger?.debug(`[GapRefresh] Refreshed stale dimension ${dim.name}: confidence ${dim.confidence}`);
+                        }
+                    }
+                    catch (err) {
+                        ctx.logger?.warn(`[GapRefresh] Failed to refresh ${dim.name}: ${err instanceof Error ? err.message : String(err)}`);
+                    }
+                }
+            }
+            // Persist refreshed dimension values to avoid re-measuring on the next iteration
+            if (anyRefreshed) {
+                try {
+                    await ctx.deps.stateManager.saveGoal(goal);
+                    ctx.logger?.debug('[GapRefresh] Persisted refreshed dimensions for goal ' + goalId);
+                }
+                catch (err) {
+                    ctx.logger?.warn?.('[GapRefresh] Failed to persist refreshed dimensions: ' + String(err));
+                }
+            }
+        }
+        gapVector = ctx.deps.gapCalculator.calculateGapVector(goalId, goal.dimensions, goal.uncertainty_weight);
+        const gapValues = gapVector.gaps.map((g) => g.normalized_weighted_gap);
+        gapAggregate = ctx.deps.gapCalculator.aggregateGaps(gapValues, goal.gap_aggregation);
+        result.gapAggregate = gapAggregate;
+        await ctx.deps.stateManager.appendGapHistoryEntry(goalId, {
+            iteration: loopIndex,
+            timestamp: new Date().toISOString(),
+            gap_vector: gapVector.gaps.map((g) => ({
+                dimension_name: g.dimension_name,
+                normalized_weighted_gap: g.normalized_weighted_gap,
+            })),
+            confidence_vector: gapVector.gaps.map((g) => ({
+                dimension_name: g.dimension_name,
+                confidence: g.confidence,
+            })),
+        });
+    }
+    catch (err) {
+        result.error = `Gap calculation failed: ${err instanceof Error ? err.message : String(err)}`;
+        ctx.logger?.error(`CoreLoop: ${result.error}`, { goalId });
+        result.elapsedMs = Date.now() - startTime;
+        return null;
+    }
+    // Gap zero check — gap is satisfied; skip task generation but continue to
+    // Phase 5 so SatisficingJudge can enforce confidence and double-confirmation.
+    if (gapAggregate === 0) {
+        ctx.logger?.info(`[CoreLoop] gap=0 for goal ${goalId} — skipping task generation, deferring to SatisficingJudge`);
+        return { gapVector, gapAggregate, skipTaskGeneration: true };
+    }
+    const avgConf = gapVector.gaps.length > 0
+        ? gapVector.gaps.reduce((s, g) => s + g.confidence, 0) / gapVector.gaps.length
+        : undefined;
+    ctx.deps.onProgress?.({
+        iteration: loopIndex + 1,
+        maxIterations: ctx.config.maxIterations,
+        phase: "Generating task...",
+        gap: gapAggregate,
+        confidence: avgConf,
+    });
+    return { gapVector, gapAggregate };
+}
+// ─── Phase 4 ───
+/** Score drives, update DriveScoreAdapter, check knowledge gap.
+ * Returns ranked DriveScores with highDissatisfactionDimensions, or null if the caller should
+ * return result early (knowledge gap task generated or drive scoring failed). */
+export async function scoreDrivesAndCheckKnowledge(ctx, goalId, goal, gapVector, loopIndex, result, startTime, tryGenerateReport) {
+    let driveScores;
+    let highDissatisfactionDimensions = [];
+    try {
+        const driveContext = buildDriveContext(goal);
+        driveScores = ctx.deps.driveScorer.scoreAllDimensions(gapVector, driveContext);
+        const rankedScores = ctx.deps.driveScorer.rankDimensions(driveScores);
+        result.driveScores = rankedScores;
+        driveScores = rankedScores;
+        if (ctx.deps.driveScoreAdapter) {
+            ctx.deps.driveScoreAdapter.update(driveScores);
+        }
+        // Extract dimensions with high dissatisfaction (> 0.7) for memory tier promotion
+        highDissatisfactionDimensions = driveScores
+            .filter((s) => s.dissatisfaction > 0.7)
+            .map((s) => s.dimension_name);
+        // Consolidated reward computation log (PULSEED_REWARD_LOG=1 to enable)
+        const confidenceAvg = gapVector.gaps.reduce((sum, g) => sum + g.confidence, 0) /
+            Math.max(gapVector.gaps.length, 1);
+        let trustScore = null;
+        if (ctx.deps.trustManager) {
+            try {
+                const balance = await ctx.deps.trustManager.getBalance(ctx.config.adapterType);
+                trustScore = balance.balance;
+            }
+            catch {
+                // Non-fatal: trust score is diagnostic-only
+            }
+        }
+        logRewardComputation({
+            goalId,
+            iteration: loopIndex,
+            gapAggregate: result.gapAggregate ?? 0,
+            confidenceAvg,
+            trustScore,
+            driveScores,
+            completionJudgment: null,
+        });
+    }
+    catch (err) {
+        result.error = `Drive scoring failed: ${err instanceof Error ? err.message : String(err)}`;
+        ctx.logger?.error(`CoreLoop: ${result.error}`, { goalId });
+        result.elapsedMs = Date.now() - startTime;
+        return null;
+    }
+    // Knowledge gap check
+    if (ctx.deps.knowledgeManager) {
+        try {
+            let strategies = null;
+            try {
+                const portfolio = await ctx.deps.strategyManager.getPortfolio(goalId);
+                strategies = portfolio !== null ? portfolio.strategies : null;
+            }
+            catch {
+                // If strategy loading fails, leave as null
+            }
+            const observationContext = {
+                observations: goal.dimensions.map((d) => ({
+                    name: d.name,
+                    current_value: d.current_value,
+                    confidence: d.confidence,
+                })),
+                strategies,
+                confidence: gapVector.gaps.reduce((sum, g) => sum + g.confidence, 0) /
+                    Math.max(gapVector.gaps.length, 1),
+            };
+            // Skip knowledge gap detection when:
+            // 1. Observations are purely self-report (confidence <= 0.3, no data sources)
+            // 2. Not the first iteration — prevents repeated gap detection from blocking
+            //    task execution every loop. Gap detection runs once; after that, let the
+            //    normal task cycle proceed.
+            const skipGapDetection = observationContext.confidence <= 0.3 ||
+                !Number.isFinite(observationContext.confidence) ||
+                loopIndex > 0;
+            const gapSignal = skipGapDetection
+                ? null
+                : await ctx.deps.knowledgeManager.detectKnowledgeGap(observationContext);
+            if (gapSignal !== null) {
+                const acquisitionTask = await ctx.deps.knowledgeManager.generateAcquisitionTask(gapSignal, goalId);
+                const acquisitionVerification = {
+                    task_id: acquisitionTask.id,
+                    verdict: "pass",
+                    confidence: 0.9,
+                    evidence: [
+                        {
+                            layer: "mechanical",
+                            description: "Knowledge acquisition task generated for gap: " + gapSignal.signal_type,
+                            confidence: 0.9,
+                        },
+                    ],
+                    dimension_updates: [],
+                    timestamp: new Date().toISOString(),
+                };
+                result.taskResult = {
+                    task: acquisitionTask,
+                    verificationResult: acquisitionVerification,
+                    action: "completed",
+                };
+                tryGenerateReport(goalId, loopIndex, result, goal);
+                result.elapsedMs = Date.now() - startTime;
+                return null;
+            }
+        }
+        catch {
+            // Knowledge gap detection failure is non-fatal
+        }
+    }
+    return { driveScores, highDissatisfactionDimensions };
+}
+//# sourceMappingURL=preparation.js.map

package/dist/orchestrator/loop/core-loop/preparation.js.map

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

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

@@ -0,0 +1,29 @@
+/**
+ * Completion checks, stall handling, 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";
+/** 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>;
+/** Stall detection per-dimension and globally, plus portfolio rebalance. */
+export declare function detectStallsAndRebalance(ctx: PhaseCtx, goalId: string, goal: Goal, result: LoopIterationResult): 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;
+}
+/** 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): Promise<boolean>;
+//# sourceMappingURL=task-cycle.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"task-cycle.d.ts","sourceRoot":"","sources":["../../../../src/orchestrator/loop/core-loop/task-cycle.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,6BAA6B,CAAC;AACxD,OAAO,KAAK,EAAE,SAAS,EAAmB,MAAM,4BAA4B,CAAC;AAE7E,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;AAYjD,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,iBAAiB,CAAC;AAIpE;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,4EAA4E;AAC5E,wBAAsB,wBAAwB,CAC5C,GAAG,EAAE,QAAQ,EACb,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,IAAI,EACV,MAAM,EAAE,mBAAmB,GAC1B,OAAO,CAAC,IAAI,CAAC,CAoGf;AA6QD;+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;;;+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,GACvB,OAAO,CAAC,OAAO,CAAC,CA+SlB"}