conatus 0.1.0

package/dist/loop/core-loop-phases.js

@@ -0,0 +1,228 @@
+/**
+ * core-loop-phases.ts
+ *
+ * Phases 1–4 of CoreLoop.runOneIteration() as standalone functions.
+ * Each function accepts a PhaseCtx (deps + config + logger) plus phase-specific
+ * parameters. They mutate `result` by reference and return values as documented.
+ *
+ * Phases 5–7 are in core-loop-phases-b.ts.
+ */
+import { buildDriveContext, } from "./core-loop-types.js";
+import { logRewardComputation } from "../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 2 ───
+/** Run observation engine, reload goal after observation.
+ * Observation failure is non-fatal — returns current goal state. */
+export async function observeAndReload(ctx, goalId, goal, loopIndex) {
+    ctx.deps.onProgress?.({
+        iteration: loopIndex + 1,
+        maxIterations: ctx.config.maxIterations,
+        phase: "Observing...",
+    });
+    try {
+        const engine = ctx.deps.observationEngine;
+        ctx.logger?.debug("CoreLoop: engine.getDataSources exists", { exists: typeof engine.getDataSources === "function" });
+        const dataSources = typeof engine.getDataSources === "function"
+            ? engine.getDataSources()
+            : [];
+        ctx.logger?.debug("CoreLoop: observation setup", { dataSourceCount: dataSources.length });
+        if (typeof engine.observe === "function") {
+            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 if gap is zero
+ * (result is mutated with early completion) or on error. */
+export async function calculateGapOrComplete(ctx, goalId, goal, loopIndex, result, startTime) {
+    let gapVector;
+    let gapAggregate;
+    try {
+        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 — goal already satisfied
+    if (gapAggregate === 0) {
+        ctx.logger?.info(`[CoreLoop] gap=0 for goal ${goalId} — skipping task generation`);
+        result.completionJudgment = {
+            is_complete: true,
+            blocking_dimensions: [],
+            low_confidence_dimensions: [],
+            needs_verification_task: false,
+            checked_at: new Date().toISOString(),
+        };
+        result.elapsedMs = Date.now() - startTime;
+        return null;
+    }
+    ctx.deps.onProgress?.({
+        iteration: loopIndex + 1,
+        maxIterations: ctx.config.maxIterations,
+        phase: "Generating task...",
+        gap: gapAggregate,
+    });
+    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 (MOTIVA_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),
+            };
+            const gapSignal = 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=core-loop-phases.js.map

package/dist/loop/core-loop-phases.js.map

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

package/dist/loop/core-loop-types.d.ts

@@ -0,0 +1,202 @@
+import { CuriosityEngine } from "../traits/curiosity-engine.js";
+import type { Logger } from "../runtime/logger.js";
+import type { TrustManager } from "../traits/trust-manager.js";
+import type { KnowledgeTransfer } from "../knowledge/knowledge-transfer.js";
+import type { TransferCandidate } from "../types/cross-portfolio.js";
+import type { CrossGoalPortfolio } from "../strategy/cross-goal-portfolio.js";
+import type { GoalTreeManager } from "../goal/goal-tree-manager.js";
+import type { StateAggregator } from "../goal/state-aggregator.js";
+import type { TreeLoopOrchestrator } from "../goal/tree-loop-orchestrator.js";
+import type { StateManager } from "../state-manager.js";
+import type { ObservationEngine } from "../observation/observation-engine.js";
+import type { TaskLifecycle, TaskCycleResult } from "../execution/task-lifecycle.js";
+import type { SatisficingJudge } from "../drive/satisficing-judge.js";
+import type { StallDetector } from "../drive/stall-detector.js";
+import type { StrategyManager } from "../strategy/strategy-manager.js";
+import type { DriveSystem } from "../drive/drive-system.js";
+import type { AdapterRegistry } from "../execution/adapter-layer.js";
+import type { KnowledgeManager } from "../knowledge/knowledge-manager.js";
+import type { CapabilityDetector } from "../observation/capability-detector.js";
+import type { PortfolioManager } from "../portfolio-manager.js";
+import type { GoalDependencyGraph } from "../goal/goal-dependency-graph.js";
+import type { LearningPipeline } from "../knowledge/learning-pipeline.js";
+import { DriveScoreAdapter } from "../knowledge/memory-lifecycle.js";
+import type { MemoryLifecycleManager } from "../knowledge/memory-lifecycle.js";
+import type { ParallelExecutor } from "../execution/parallel-executor.js";
+import type { Goal } from "../types/goal.js";
+import type { GapVector } from "../types/gap.js";
+import type { DriveContext, DriveScore } from "../types/drive.js";
+import type { CompletionJudgment } from "../types/satisficing.js";
+import type { StallReport, StallAnalysis } from "../types/stall.js";
+export interface GapCalculatorModule {
+    calculateGapVector: (goalId: string, dimensions: Goal["dimensions"], globalUncertaintyWeight?: number) => GapVector;
+    aggregateGaps: (childGaps: number[], method?: "max" | "weighted_avg" | "sum", weights?: number[]) => number;
+}
+export interface DriveScorerModule {
+    scoreAllDimensions: (gapVector: GapVector, context: DriveContext, config?: unknown) => DriveScore[];
+    rankDimensions: (scores: DriveScore[]) => DriveScore[];
+}
+export interface ExecutionSummaryParams {
+    goalId: string;
+    loopIndex: number;
+    observation: {
+        dimensionName: string;
+        progress: number;
+        confidence: number;
+    }[];
+    gapAggregate: number;
+    taskResult: {
+        taskId: string;
+        action: string;
+        dimension: string;
+    } | null;
+    stallDetected: boolean;
+    pivotOccurred: boolean;
+    elapsedMs: number;
+}
+export interface ReportingEngine {
+    generateExecutionSummary(params: ExecutionSummaryParams): unknown;
+    saveReport(report: unknown): void;
+}
+export interface LoopConfig {
+    maxIterations?: number;
+    maxConsecutiveErrors?: number;
+    delayBetweenLoopsMs?: number;
+    adapterType?: string;
+    treeMode?: boolean;
+    multiGoalMode?: boolean;
+    goalIds?: string[];
+    /**
+     * Minimum number of iterations to run before the loop can exit on completion.
+     * Default: 1 (at least one full task cycle always runs before declaring complete).
+     * Setting to 2 forces two full iterations even if the goal is already satisfied after iteration 1.
+     */
+    minIterations?: number;
+    /**
+     * Whether to automatically archive a completed goal at the end of run().
+     * Default: false — archiving is an irreversible action and should be triggered explicitly
+     * (e.g. via `motiva goal archive <id>` CLI command or by setting this flag intentionally).
+     */
+    autoArchive?: boolean;
+}
+export interface LoopIterationResult {
+    loopIndex: number;
+    goalId: string;
+    gapAggregate: number;
+    driveScores: DriveScore[];
+    taskResult: TaskCycleResult | null;
+    stallDetected: boolean;
+    stallReport: StallReport | null;
+    /** M14-S2: cause analysis result when a stall is detected */
+    stallAnalysis?: StallAnalysis;
+    pivotOccurred: boolean;
+    completionJudgment: CompletionJudgment;
+    elapsedMs: number;
+    error: string | null;
+    /** Alerts for milestones that are at_risk or behind (optional) */
+    milestoneAlerts?: Array<{
+        goalId: string;
+        status: string;
+        pace_ratio: number;
+    }>;
+    /** Transfer candidates detected from cross-goal knowledge (suggestion-only, Phase 1) */
+    transfer_candidates?: TransferCandidate[];
+}
+export interface LoopResult {
+    goalId: string;
+    totalIterations: number;
+    finalStatus: "completed" | "stalled" | "max_iterations" | "error" | "stopped";
+    iterations: LoopIterationResult[];
+    startedAt: string;
+    completedAt: string;
+}
+export interface CoreLoopDeps {
+    stateManager: StateManager;
+    observationEngine: ObservationEngine;
+    gapCalculator: GapCalculatorModule;
+    driveScorer: DriveScorerModule;
+    taskLifecycle: TaskLifecycle;
+    satisficingJudge: SatisficingJudge;
+    stallDetector: StallDetector;
+    strategyManager: StrategyManager;
+    reportingEngine: ReportingEngine;
+    driveSystem: DriveSystem;
+    adapterRegistry: AdapterRegistry;
+    knowledgeManager?: KnowledgeManager;
+    capabilityDetector?: CapabilityDetector;
+    portfolioManager?: PortfolioManager;
+    curiosityEngine?: CuriosityEngine;
+    goalDependencyGraph?: GoalDependencyGraph;
+    goalTreeManager?: GoalTreeManager;
+    stateAggregator?: StateAggregator;
+    treeLoopOrchestrator?: TreeLoopOrchestrator;
+    crossGoalPortfolio?: CrossGoalPortfolio;
+    learningPipeline?: LearningPipeline;
+    knowledgeTransfer?: KnowledgeTransfer;
+    memoryLifecycleManager?: MemoryLifecycleManager;
+    /**
+     * Optional adapter that bridges DriveScorer output to MemoryLifecycleManager.
+     * When provided, CoreLoop calls adapter.update(driveScores) after each drive
+     * scoring step so MemoryLifecycleManager can use live dissatisfaction values
+     * for compression delay and relevance scoring.
+     *
+     * Typical setup (in CLIRunner):
+     *   const adapter = new DriveScoreAdapter();
+     *   const mlm = new MemoryLifecycleManager(baseDir, llm, config, emb, vec, adapter);
+     *   const loop = new CoreLoop({ ..., memoryLifecycleManager: mlm, driveScoreAdapter: adapter });
+     */
+    driveScoreAdapter?: DriveScoreAdapter;
+    /**
+     * Optional TrustManager for including per-adapter trust balance in reward logs.
+     * When provided, CoreLoop reads the balance for the configured adapterType and
+     * includes it in logRewardComputation calls (MOTIVA_REWARD_LOG=1).
+     */
+    trustManager?: TrustManager;
+    /**
+     * Optional ParallelExecutor for TaskGroup execution (M15 Phase 2).
+     * When provided, tasks evaluated as "large" complexity will be decomposed
+     * into a TaskGroup and executed in parallel waves.
+     * If not provided, all tasks fall through to the normal single-task flow.
+     */
+    parallelExecutor?: ParallelExecutor;
+    /**
+     * Optional factory function to generate a TaskGroup for a large task.
+     * Provided as a callback so the caller owns the llmClient dependency.
+     * If not provided (or returns null), the normal single-task flow is used.
+     */
+    generateTaskGroupFn?: (context: {
+        goalDescription: string;
+        targetDimension: string;
+        currentState: string;
+        gap: number;
+        availableAdapters: string[];
+        contextBlock?: string;
+    }) => Promise<import("../types/index.js").TaskGroup | null>;
+    logger?: Logger;
+    /** Optional context provider for workspace-aware task generation */
+    contextProvider?: (goalId: string, dimensionName: string) => Promise<string>;
+    /**
+     * Optional progress callback. Called at key phases during each iteration so
+     * callers (e.g. CLIRunner) can print user-friendly progress lines.
+     */
+    onProgress?: (event: ProgressEvent) => void;
+}
+export interface ProgressEvent {
+    /** 1-based iteration number */
+    iteration: number;
+    /** Maximum iterations configured */
+    maxIterations: number;
+    /** Current phase label */
+    phase: string;
+    /** Gap aggregate from latest gap calculation (undefined before first gap calc) */
+    gap?: number;
+    /** Short description of the task being executed (undefined outside execute phase) */
+    taskDescription?: string;
+}
+/**
+ * Build DriveContext from goal state.
+ * For each dimension, compute hours since last update.
+ * Deadline comes from goal.deadline if set.
+ */
+export declare function buildDriveContext(goal: Goal): DriveContext;
+//# sourceMappingURL=core-loop-types.d.ts.map

package/dist/loop/core-loop-types.d.ts.map

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

package/dist/loop/core-loop-types.js

@@ -0,0 +1,38 @@
+// ─── Helpers ───
+/**
+ * Build DriveContext from goal state.
+ * For each dimension, compute hours since last update.
+ * Deadline comes from goal.deadline if set.
+ */
+export function buildDriveContext(goal) {
+    const timeSinceLastAttempt = {};
+    const deadlines = {};
+    const opportunities = {};
+    const now = Date.now();
+    for (const dim of goal.dimensions) {
+        // Calculate hours since last update
+        if (dim.last_updated) {
+            const lastUpdated = new Date(dim.last_updated).getTime();
+            timeSinceLastAttempt[dim.name] = (now - lastUpdated) / (1000 * 60 * 60);
+        }
+        else {
+            // No previous attempt — use a large number to indicate high staleness
+            timeSinceLastAttempt[dim.name] = 168; // 1 week default
+        }
+        // Deadline: compute hours remaining from goal.deadline
+        if (goal.deadline) {
+            const deadlineTime = new Date(goal.deadline).getTime();
+            const hoursRemaining = (deadlineTime - now) / (1000 * 60 * 60);
+            deadlines[dim.name] = hoursRemaining;
+        }
+        else {
+            deadlines[dim.name] = null;
+        }
+    }
+    return {
+        time_since_last_attempt: timeSinceLastAttempt,
+        deadlines,
+        opportunities,
+    };
+}
+//# sourceMappingURL=core-loop-types.js.map

package/dist/loop/core-loop-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"core-loop-types.js","sourceRoot":"","sources":["../../src/loop/core-loop-types.ts"],"names":[],"mappings":"AA0NA,kBAAkB;AAElB;;;;GAIG;AACH,MAAM,UAAU,iBAAiB,CAAC,IAAU;IAC1C,MAAM,oBAAoB,GAA2B,EAAE,CAAC;IACxD,MAAM,SAAS,GAAkC,EAAE,CAAC;IACpD,MAAM,aAAa,GAA2D,EAAE,CAAC;IAEjF,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAEvB,KAAK,MAAM,GAAG,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;QAClC,oCAAoC;QACpC,IAAI,GAAG,CAAC,YAAY,EAAE,CAAC;YACrB,MAAM,WAAW,GAAG,IAAI,IAAI,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC,OAAO,EAAE,CAAC;YACzD,oBAAoB,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,GAAG,WAAW,CAAC,GAAG,CAAC,IAAI,GAAG,EAAE,GAAG,EAAE,CAAC,CAAC;QAC1E,CAAC;aAAM,CAAC;YACN,sEAAsE;YACtE,oBAAoB,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,GAAG,CAAC,CAAC,iBAAiB;QACzD,CAAC;QAED,uDAAuD;QACvD,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YAClB,MAAM,YAAY,GAAG,IAAI,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,OAAO,EAAE,CAAC;YACvD,MAAM,cAAc,GAAG,CAAC,YAAY,GAAG,GAAG,CAAC,GAAG,CAAC,IAAI,GAAG,EAAE,GAAG,EAAE,CAAC,CAAC;YAC/D,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,cAAc,CAAC;QACvC,CAAC;aAAM,CAAC;YACN,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;QAC7B,CAAC;IACH,CAAC;IAED,OAAO;QACL,uBAAuB,EAAE,oBAAoB;QAC7C,SAAS;QACT,aAAa;KACd,CAAC;AACJ,CAAC"}

package/dist/loop/tree-loop-runner.d.ts

@@ -0,0 +1,24 @@
+import type { CoreLoopDeps, LoopConfig, LoopIterationResult } from "./core-loop-types.js";
+import type { Logger } from "../runtime/logger.js";
+/**
+ * Standalone function extracted from CoreLoop.runTreeIteration.
+ *
+ * Tree-mode iteration: select one node via TreeLoopOrchestrator, run a
+ * normal observe→gap→score→task cycle on that node, then aggregate upward.
+ */
+export declare function runTreeIteration(rootId: string, loopIndex: number, deps: CoreLoopDeps, config: Required<LoopConfig>, logger: Logger | undefined, runOneIteration: (goalId: string, loopIndex: number) => Promise<LoopIterationResult>): Promise<LoopIterationResult>;
+/**
+ * Standalone function extracted from CoreLoop.runMultiGoalIteration.
+ *
+ * Run one iteration of the multi-goal loop.
+ *
+ * Uses CrossGoalPortfolio (if available) to determine goal allocations,
+ * then calls portfolioManager.selectNextStrategyAcrossGoals() to pick
+ * which goal gets the next iteration. Falls back to equal allocation if
+ * CrossGoalPortfolio is not injected.
+ *
+ * Requires config.multiGoalMode=true and config.goalIds to be set.
+ * Throws if CrossGoalPortfolio is not injected and multiGoalMode is enabled.
+ */
+export declare function runMultiGoalIteration(loopIndex: number, deps: CoreLoopDeps, config: Required<LoopConfig>, runOneIteration: (goalId: string, loopIndex: number) => Promise<LoopIterationResult>): Promise<LoopIterationResult>;
+//# sourceMappingURL=tree-loop-runner.d.ts.map

package/dist/loop/tree-loop-runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tree-loop-runner.d.ts","sourceRoot":"","sources":["../../src/loop/tree-loop-runner.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAC1F,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAEnD;;;;;GAKG;AACH,wBAAsB,gBAAgB,CACpC,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,YAAY,EAClB,MAAM,EAAE,QAAQ,CAAC,UAAU,CAAC,EAC5B,MAAM,EAAE,MAAM,GAAG,SAAS,EAC1B,eAAe,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,KAAK,OAAO,CAAC,mBAAmB,CAAC,GACnF,OAAO,CAAC,mBAAmB,CAAC,CAkE9B;AAED;;;;;;;;;;;;GAYG;AACH,wBAAsB,qBAAqB,CACzC,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,YAAY,EAClB,MAAM,EAAE,QAAQ,CAAC,UAAU,CAAC,EAC5B,eAAe,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,KAAK,OAAO,CAAC,mBAAmB,CAAC,GACnF,OAAO,CAAC,mBAAmB,CAAC,CA6C9B"}

package/dist/loop/tree-loop-runner.js

@@ -0,0 +1,116 @@
+/**
+ * Standalone function extracted from CoreLoop.runTreeIteration.
+ *
+ * Tree-mode iteration: select one node via TreeLoopOrchestrator, run a
+ * normal observe→gap→score→task cycle on that node, then aggregate upward.
+ */
+export async function runTreeIteration(rootId, loopIndex, deps, config, logger, runOneIteration) {
+    const orchestrator = deps.treeLoopOrchestrator;
+    // 0. Auto-decompose if root has no children yet
+    const rootGoalForDecomp = await deps.stateManager.loadGoal(rootId);
+    if (rootGoalForDecomp && rootGoalForDecomp.children_ids.length === 0 && deps.goalTreeManager) {
+        const defaultConfig = { min_specificity: 0.7, max_depth: 3, parallel_loop_limit: 3, auto_prune_threshold: 0.3 };
+        try {
+            logger?.info("CoreLoop: auto-decomposing goal tree", { rootId });
+            const decompResult = await deps.goalTreeManager.decomposeGoal(rootId, defaultConfig);
+            logger?.info("CoreLoop: decomposition complete", { rootId, childCount: decompResult.children.length });
+            await deps.treeLoopOrchestrator?.startTreeExecution(rootId, defaultConfig);
+        }
+        catch (err) {
+            logger?.warn("CoreLoop: decomposition failed, falling back to flat iteration", { rootId, err });
+        }
+    }
+    // 1. Select next node to iterate
+    const selectedNodeId = await orchestrator.selectNextNode(rootId);
+    // 2. If null, all nodes are completed/paused — check root completion
+    if (selectedNodeId === null) {
+        const rootGoal = await deps.stateManager.loadGoal(rootId);
+        const isComplete = rootGoal
+            ? (rootGoal.children_ids.length > 0
+                ? await deps.satisficingJudge.judgeTreeCompletion(rootId)
+                : deps.satisficingJudge.isGoalComplete(rootGoal))
+            : { is_complete: false, blocking_dimensions: [], low_confidence_dimensions: [], needs_verification_task: false, checked_at: new Date().toISOString() };
+        return {
+            loopIndex,
+            goalId: rootId,
+            gapAggregate: 0,
+            driveScores: [],
+            taskResult: null,
+            stallDetected: false,
+            stallReport: null,
+            pivotOccurred: false,
+            completionJudgment: isComplete,
+            elapsedMs: 0,
+            error: null,
+        };
+    }
+    // 3. Run normal iteration on selected node
+    const result = await runOneIteration(selectedNodeId, loopIndex);
+    // 3b. After each iteration, propagate state upward through parent chain
+    if (deps.stateAggregator) {
+        const selectedGoal = await deps.stateManager.loadGoal(selectedNodeId);
+        let parentId = selectedGoal?.parent_id ?? null;
+        while (parentId !== null) {
+            try {
+                await deps.stateAggregator.aggregateChildStates(parentId);
+            }
+            catch {
+                break;
+            }
+            const parent = await deps.stateManager.loadGoal(parentId);
+            parentId = parent?.parent_id ?? null;
+        }
+    }
+    // 4. If the node's goal is now completed, call onNodeCompleted
+    if (result.completionJudgment.is_complete) {
+        await orchestrator.onNodeCompleted(selectedNodeId);
+    }
+    return result;
+}
+/**
+ * Standalone function extracted from CoreLoop.runMultiGoalIteration.
+ *
+ * Run one iteration of the multi-goal loop.
+ *
+ * Uses CrossGoalPortfolio (if available) to determine goal allocations,
+ * then calls portfolioManager.selectNextStrategyAcrossGoals() to pick
+ * which goal gets the next iteration. Falls back to equal allocation if
+ * CrossGoalPortfolio is not injected.
+ *
+ * Requires config.multiGoalMode=true and config.goalIds to be set.
+ * Throws if CrossGoalPortfolio is not injected and multiGoalMode is enabled.
+ */
+export async function runMultiGoalIteration(loopIndex, deps, config, runOneIteration) {
+    if (!config.multiGoalMode || !config.goalIds || config.goalIds.length === 0) {
+        throw new Error("runMultiGoalIteration requires config.multiGoalMode=true and config.goalIds to be non-empty");
+    }
+    const goalIds = config.goalIds;
+    // Build allocation map
+    let allocationMap;
+    if (deps.crossGoalPortfolio) {
+        allocationMap = await deps.crossGoalPortfolio.getAllocationMap(goalIds);
+    }
+    else {
+        // Fall back to equal allocation when CrossGoalPortfolio is not provided
+        const equalShare = 1.0 / goalIds.length;
+        allocationMap = new Map(goalIds.map((id) => [id, equalShare]));
+    }
+    // Select next goal + strategy using PortfolioManager
+    if (!deps.portfolioManager) {
+        // Without a portfolio manager, round-robin by loopIndex
+        const selectedGoalId = goalIds[loopIndex % goalIds.length];
+        return runOneIteration(selectedGoalId, loopIndex);
+    }
+    const selection = await deps.portfolioManager.selectNextStrategyAcrossGoals(goalIds, allocationMap);
+    if (selection === null) {
+        // No strategies available — return a no-op result for the first goal
+        const fallbackGoalId = goalIds[0];
+        return runOneIteration(fallbackGoalId, loopIndex);
+    }
+    // Record that a task was dispatched for this goal
+    deps.portfolioManager.recordGoalTaskDispatched(selection.goal_id);
+    // Run normal iteration for the selected goal
+    const result = await runOneIteration(selection.goal_id, loopIndex);
+    return result;
+}
+//# sourceMappingURL=tree-loop-runner.js.map

package/dist/loop/tree-loop-runner.js.map

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