pulseed 0.4.0 → 0.4.2

package/dist/orchestrator/loop/checkpoint-manager-loop.d.ts

@@ -9,7 +9,7 @@
  */
 import type { StateManager } from "../../base/state/state-manager.js";
 import type { TrustManager } from "../../platform/traits/trust-manager.js";
-import type { LoopIterationResult } from "./core-loop-types.js";
+import type { LoopIterationResult } from "./core-loop/contracts.js";
 import type { Logger } from "../../runtime/logger.js";
 /**
  * Save a checkpoint after a successful verify step.

package/dist/orchestrator/loop/checkpoint-manager-loop.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"checkpoint-manager-loop.d.ts","sourceRoot":"","sources":["../../../src/orchestrator/loop/checkpoint-manager-loop.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mCAAmC,CAAC;AACtE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wCAAwC,CAAC;AAC3E,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAChE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAC;AAEtD;;;;GAIG;AACH,wBAAsB,kBAAkB,CACtC,YAAY,EAAE,YAAY,EAC1B,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,EACjB,eAAe,EAAE,mBAAmB,EACpC,WAAW,EAAE,MAAM,EACnB,YAAY,EAAE,YAAY,GAAG,SAAS,EACtC,MAAM,EAAE,MAAM,GAAG,SAAS,GACzB,OAAO,CAAC,IAAI,CAAC,CAoCf;AAED;;;;;;GAMG;AACH,wBAAsB,qBAAqB,CACzC,YAAY,EAAE,YAAY,EAC1B,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,MAAM,EACnB,YAAY,EAAE,YAAY,GAAG,SAAS,GACrC,OAAO,CAAC,MAAM,CAAC,CAEjB"}
+{"version":3,"file":"checkpoint-manager-loop.d.ts","sourceRoot":"","sources":["../../../src/orchestrator/loop/checkpoint-manager-loop.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mCAAmC,CAAC;AACtE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wCAAwC,CAAC;AAC3E,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AACpE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAC;AAEtD;;;;GAIG;AACH,wBAAsB,kBAAkB,CACtC,YAAY,EAAE,YAAY,EAC1B,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,EACjB,eAAe,EAAE,mBAAmB,EACpC,WAAW,EAAE,MAAM,EACnB,YAAY,EAAE,YAAY,GAAG,SAAS,EACtC,MAAM,EAAE,MAAM,GAAG,SAAS,GACzB,OAAO,CAAC,IAAI,CAAC,CAoCf;AAED;;;;;;GAMG;AACH,wBAAsB,qBAAqB,CACzC,YAAY,EAAE,YAAY,EAC1B,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,MAAM,EACnB,YAAY,EAAE,YAAY,GAAG,SAAS,GACrC,OAAO,CAAC,MAAM,CAAC,CAEjB"}

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

@@ -0,0 +1,22 @@
+/**
+ * Capability acquisition helpers used from the CoreLoop task cycle.
+ */
+import type { Logger } from "../../../runtime/logger.js";
+import type { IAdapter } from "../../execution/adapter-layer.js";
+import type { CapabilityDetector } from "../../../platform/observation/capability-detector.js";
+import type { CapabilityAcquisitionTask } from "../../../base/types/capability.js";
+export interface CapabilityAcquisitionOutcome {
+    capabilityName: string;
+    replanRequired: boolean;
+    recommendationSource?: string;
+    recommendedPlugin?: string;
+}
+/** Handle the "capability_acquiring" action from TaskLifecycle.
+ * Delegates acquisition to an adapter, verifies the result, and registers
+ * the capability on success. Retries up to 3 times before escalating. */
+export declare function handleCapabilityAcquisition(acquisitionTask: CapabilityAcquisitionTask, goalId: string, adapter: IAdapter, capabilityDetector: CapabilityDetector | undefined, capabilityAcquisitionFailures: Map<string, number>, logger: Logger | undefined): Promise<CapabilityAcquisitionOutcome>;
+/** Records a capability acquisition failure and escalates after 3 consecutive failures. */
+export declare function recordCapabilityFailure(capabilityDetector: CapabilityDetector, acquisitionTask: CapabilityAcquisitionTask, goalId: string, capabilityAcquisitionFailures: Map<string, number>, logger: Logger | undefined): Promise<void>;
+/** Escalates a capability acquisition failure to the user and marks status as verification_failed. */
+export declare function escalateCapability(capabilityDetector: CapabilityDetector, acquisitionTask: CapabilityAcquisitionTask, goalId: string, logger: Logger | undefined): Promise<void>;
+//# sourceMappingURL=capability.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"capability.d.ts","sourceRoot":"","sources":["../../../../src/orchestrator/loop/core-loop/capability.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,4BAA4B,CAAC;AACzD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,kCAAkC,CAAC;AACjE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,sDAAsD,CAAC;AAC/F,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,mCAAmC,CAAC;AAEnF,MAAM,WAAW,4BAA4B;IAC3C,cAAc,EAAE,MAAM,CAAC;IACvB,cAAc,EAAE,OAAO,CAAC;IACxB,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED;;yEAEyE;AACzE,wBAAsB,2BAA2B,CAC/C,eAAe,EAAE,yBAAyB,EAC1C,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,QAAQ,EACjB,kBAAkB,EAAE,kBAAkB,GAAG,SAAS,EAClD,6BAA6B,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,EAClD,MAAM,EAAE,MAAM,GAAG,SAAS,GACzB,OAAO,CAAC,4BAA4B,CAAC,CA+HvC;AAED,2FAA2F;AAC3F,wBAAsB,uBAAuB,CAC3C,kBAAkB,EAAE,kBAAkB,EACtC,eAAe,EAAE,yBAAyB,EAC1C,MAAM,EAAE,MAAM,EACd,6BAA6B,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,EAClD,MAAM,EAAE,MAAM,GAAG,SAAS,GACzB,OAAO,CAAC,IAAI,CAAC,CAUf;AAED,sGAAsG;AACtG,wBAAsB,kBAAkB,CACtC,kBAAkB,EAAE,kBAAkB,EACtC,eAAe,EAAE,yBAAyB,EAC1C,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,GAAG,SAAS,GACzB,OAAO,CAAC,IAAI,CAAC,CAcf"}

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

@@ -0,0 +1,151 @@
+/**
+ * Capability acquisition helpers used from the CoreLoop task cycle.
+ */
+/** Handle the "capability_acquiring" action from TaskLifecycle.
+ * Delegates acquisition to an adapter, verifies the result, and registers
+ * the capability on success. Retries up to 3 times before escalating. */
+export async function handleCapabilityAcquisition(acquisitionTask, goalId, adapter, capabilityDetector, capabilityAcquisitionFailures, logger) {
+    const capName = acquisitionTask.gap.missing_capability.name;
+    const capType = acquisitionTask.gap.missing_capability.type;
+    if (!capabilityDetector) {
+        logger?.warn("CoreLoop: capability_acquiring action received but no capabilityDetector configured — skipping");
+        return { capabilityName: capName, replanRequired: false };
+    }
+    const recommendation = capabilityDetector.recommendAcquisition(acquisitionTask.gap)[0];
+    try {
+        await capabilityDetector.setCapabilityStatus(capName, capType, "requested");
+    }
+    catch {
+        // Non-fatal.
+    }
+    logger?.info("CoreLoop: handling capability acquisition", { capName, capType, method: acquisitionTask.method });
+    const recommendationBlock = recommendation
+        ? `\nRecommended acquisition path:\n` +
+            `- Plugin: ${recommendation.pluginName}\n` +
+            `- Install source: ${recommendation.installSource}\n` +
+            `- Verification hint: ${recommendation.verificationHint}\n`
+        : "";
+    const prompt = `Capability Acquisition Task\n` +
+        `Method: ${acquisitionTask.method}\n` +
+        `Description: ${acquisitionTask.task_description}\n` +
+        `Success criteria: ${acquisitionTask.success_criteria.join("; ")}\n\n` +
+        recommendationBlock +
+        `Instructions: Please acquire or set up the capability "${capName}" (${capType}). ` +
+        `Follow the method "${acquisitionTask.method}" and ensure the success criteria are met.`;
+    let agentResult;
+    try {
+        await capabilityDetector.setCapabilityStatus(capName, capType, "acquiring");
+        agentResult = await adapter.execute({ prompt, timeout_ms: 120000, adapter_type: adapter.adapterType });
+    }
+    catch (err) {
+        logger?.error("CoreLoop: adapter execution failed during capability acquisition", {
+            capName,
+            error: err instanceof Error ? err.message : String(err),
+        });
+        await recordCapabilityFailure(capabilityDetector, acquisitionTask, goalId, capabilityAcquisitionFailures, logger);
+        return {
+            capabilityName: capName,
+            replanRequired: false,
+            recommendationSource: recommendation?.installSource,
+            recommendedPlugin: recommendation?.pluginName,
+        };
+    }
+    const capability = {
+        id: capName.toLowerCase().replace(/\s+/g, "_"),
+        name: capName,
+        description: acquisitionTask.task_description,
+        type: capType,
+        status: "acquiring",
+    };
+    let verificationResult;
+    try {
+        verificationResult = await capabilityDetector.verifyAcquiredCapability(capability, acquisitionTask, agentResult);
+    }
+    catch (err) {
+        logger?.error("CoreLoop: capability verification threw an error", {
+            capName,
+            error: err instanceof Error ? err.message : String(err),
+        });
+        await recordCapabilityFailure(capabilityDetector, acquisitionTask, goalId, capabilityAcquisitionFailures, logger);
+        return {
+            capabilityName: capName,
+            replanRequired: false,
+            recommendationSource: recommendation?.installSource,
+            recommendedPlugin: recommendation?.pluginName,
+        };
+    }
+    if (verificationResult === "pass") {
+        capabilityAcquisitionFailures.delete(capName);
+        try {
+            await capabilityDetector.registerCapability(capability, {
+                goal_id: goalId,
+                originating_task_id: acquisitionTask.gap.related_task_id,
+                acquired_at: new Date().toISOString(),
+            });
+            await capabilityDetector.setCapabilityStatus(capName, capType, "available");
+            logger?.info("CoreLoop: capability acquired and registered successfully", {
+                capName,
+                replanRequired: true,
+                recommendedPlugin: recommendation?.pluginName,
+            });
+            return {
+                capabilityName: capName,
+                replanRequired: true,
+                recommendationSource: recommendation?.installSource,
+                recommendedPlugin: recommendation?.pluginName,
+            };
+        }
+        catch (err) {
+            logger?.error("CoreLoop: failed to register capability after verification pass", {
+                capName,
+                error: err instanceof Error ? err.message : String(err),
+            });
+            return {
+                capabilityName: capName,
+                replanRequired: false,
+                recommendationSource: recommendation?.installSource,
+                recommendedPlugin: recommendation?.pluginName,
+            };
+        }
+    }
+    else if (verificationResult === "escalate") {
+        capabilityAcquisitionFailures.delete(capName);
+        await escalateCapability(capabilityDetector, acquisitionTask, goalId, logger);
+    }
+    else {
+        await recordCapabilityFailure(capabilityDetector, acquisitionTask, goalId, capabilityAcquisitionFailures, logger);
+    }
+    return {
+        capabilityName: capName,
+        replanRequired: false,
+        recommendationSource: recommendation?.installSource,
+        recommendedPlugin: recommendation?.pluginName,
+    };
+}
+/** Records a capability acquisition failure and escalates after 3 consecutive failures. */
+export async function recordCapabilityFailure(capabilityDetector, acquisitionTask, goalId, capabilityAcquisitionFailures, logger) {
+    const capName = acquisitionTask.gap.missing_capability.name;
+    const currentCount = (capabilityAcquisitionFailures.get(capName) ?? 0) + 1;
+    capabilityAcquisitionFailures.set(capName, currentCount);
+    logger?.warn("CoreLoop: capability acquisition failed", { capName, failureCount: currentCount });
+    if (currentCount >= 3) {
+        await escalateCapability(capabilityDetector, acquisitionTask, goalId, logger);
+    }
+}
+/** Escalates a capability acquisition failure to the user and marks status as verification_failed. */
+export async function escalateCapability(capabilityDetector, acquisitionTask, goalId, logger) {
+    const capName = acquisitionTask.gap.missing_capability.name;
+    const capType = acquisitionTask.gap.missing_capability.type;
+    logger?.warn("CoreLoop: escalating capability acquisition to user", { capName });
+    try {
+        await capabilityDetector.escalateToUser(acquisitionTask.gap, goalId);
+        await capabilityDetector.setCapabilityStatus(capName, capType, "verification_failed");
+    }
+    catch (err) {
+        logger?.error("CoreLoop: escalation failed", {
+            capName,
+            error: err instanceof Error ? err.message : String(err),
+        });
+    }
+}
+//# sourceMappingURL=capability.js.map

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

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

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

@@ -0,0 +1,245 @@
+import type { CuriosityEngine } from "../../../platform/traits/curiosity-engine.js";
+import type { IterationBudget } from "../iteration-budget.js";
+import type { Logger } from "../../../runtime/logger.js";
+import type { StrategyTemplateRegistry } from "../../strategy/strategy-template-registry.js";
+import type { TrustManager } from "../../../platform/traits/trust-manager.js";
+import type { KnowledgeTransfer } from "../../../platform/knowledge/transfer/knowledge-transfer.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 "../../../base/state/state-manager.js";
+import type { ObservationEngine } from "../../../platform/observation/observation-engine.js";
+import type { TaskLifecycle } from "../../execution/task/task-lifecycle.js";
+import type { SatisficingJudge } from "../../../platform/drive/satisficing-judge.js";
+import type { StallDetector } from "../../../platform/drive/stall-detector.js";
+import type { StrategyManager } from "../../strategy/strategy-manager.js";
+import type { DriveSystem } from "../../../platform/drive/drive-system.js";
+import type { AdapterRegistry } from "../../execution/adapter-layer.js";
+import type { KnowledgeManager } from "../../../platform/knowledge/knowledge-manager.js";
+import type { CapabilityDetector } from "../../../platform/observation/capability-detector.js";
+import type { PortfolioManager } from "../../strategy/portfolio-manager.js";
+import type { GoalDependencyGraph } from "../../goal/goal-dependency-graph.js";
+import type { LearningPipeline } from "../../../platform/knowledge/learning/learning-pipeline.js";
+import type { DriveScoreAdapter, MemoryLifecycleManager } from "../../../platform/knowledge/memory/memory-lifecycle.js";
+import type { ParallelExecutor } from "../../execution/parallel-executor.js";
+import type { GoalRefiner } from "../../goal/goal-refiner.js";
+import type { Goal } from "../../../base/types/goal.js";
+import type { GapVector } from "../../../base/types/gap.js";
+import type { DriveContext, DriveScore } from "../../../base/types/drive.js";
+import type { ToolExecutor } from "../../../tools/executor.js";
+import type { ToolRegistry } from "../../../tools/registry.js";
+export type { LoopIterationResult, LoopResult, } from "../loop-result-types.js";
+export { makeEmptyIterationResult } from "../loop-result-types.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;
+}
+/**
+ * LoopConfig with all required fields resolved (except iterationBudget which remains optional).
+ * Used as the internal config type throughout CoreLoop and its sub-modules.
+ */
+export type ResolvedLoopConfig = Required<Omit<LoopConfig, "iterationBudget">> & Pick<LoopConfig, "iterationBudget">;
+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 `pulseed goal archive <id>` CLI command or by setting this flag intentionally).
+     */
+    autoArchive?: boolean;
+    /**
+     * When true, suppress loop-level persistence side effects: checkpoint writes,
+     * final goal status updates, and archive operations.
+     */
+    dryRun?: boolean;
+    /**
+     * Maximum number of consecutive iterations that can be skipped due to no state change
+     * (Pillar 2: State Diff + Loop Skip). After this many consecutive skips, the full loop
+     * runs regardless so stall detection can fire. Default: 5.
+     */
+    maxConsecutiveSkips?: number;
+    /**
+     * When true (default), automatically decompose an abstract goal into sub-goals
+     * using TreeLoopOrchestrator.ensureGoalRefined() before the first iteration.
+     * Set to false to disable auto-decomposition.
+     */
+    autoDecompose?: boolean;
+    /**
+     * Shared iteration budget for parent-child agent trees.
+     * When set, all iterations (including child node iterations in tree mode) consume
+     * from this budget. Prevents runaway recursion across hierarchical agent invocations.
+     * If not set, maxIterations acts as the sole upper bound.
+     */
+    iterationBudget?: IterationBudget;
+    /**
+     * When true (default), automatically consolidate agent memory when a goal completes
+     * and raw entry count exceeds consolidationRawThreshold.
+     */
+    autoConsolidateOnComplete?: boolean;
+    /**
+     * Minimum number of raw agent memory entries required to trigger auto-consolidation.
+     * Default: 20.
+     */
+    consolidationRawThreshold?: number;
+}
+/** Deps needed for observation phase */
+export interface ObservationDeps {
+    observationEngine: ObservationEngine;
+    stateManager: StateManager;
+}
+/** Deps needed for tree iteration */
+export interface TreeDeps {
+    stateManager: StateManager;
+    treeLoopOrchestrator?: TreeLoopOrchestrator;
+    satisficingJudge: SatisficingJudge;
+    goalRefiner?: GoalRefiner;
+    goalTreeManager?: GoalTreeManager;
+    stateAggregator?: StateAggregator;
+}
+/** Deps needed for stall detection and recovery */
+export interface StallDeps {
+    stallDetector: StallDetector;
+    strategyManager: StrategyManager;
+    knowledgeManager?: KnowledgeManager;
+    learningPipeline?: LearningPipeline;
+    goalRefiner?: GoalRefiner;
+}
+/** Deps needed for task execution cycle */
+export interface TaskCycleDeps {
+    taskLifecycle: TaskLifecycle;
+    adapterRegistry: AdapterRegistry;
+    portfolioManager?: PortfolioManager;
+    knowledgeManager?: KnowledgeManager;
+    contextProvider?: (goalId: string, dimensionName: string) => Promise<string>;
+}
+export interface CoreLoopDeps extends ObservationDeps, TreeDeps, StallDeps, TaskCycleDeps {
+    gapCalculator: GapCalculatorModule;
+    driveScorer: DriveScorerModule;
+    reportingEngine: ReportingEngine;
+    driveSystem: DriveSystem;
+    capabilityDetector?: CapabilityDetector;
+    curiosityEngine?: CuriosityEngine;
+    goalDependencyGraph?: GoalDependencyGraph;
+    crossGoalPortfolio?: CrossGoalPortfolio;
+    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 (PULSEED_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("../../../base/types/index.js").TaskGroup | null>;
+    logger?: Logger;
+    /**
+     * 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;
+    /**
+     * Optional StrategyTemplateRegistry. When provided, CoreLoop wires it into
+     * StrategyManager so that strategies completing with effectiveness_score >= 0.5
+     * are automatically registered as reusable templates.
+     */
+    strategyTemplateRegistry?: StrategyTemplateRegistry;
+    /** Optional HookManager for lifecycle hook events. */
+    hookManager?: import("../../../runtime/hook-manager.js").HookManager;
+    /** Optional ToolExecutor for direct tool-based operations (observation, verification, knowledge). */
+    toolExecutor?: ToolExecutor;
+    /** Optional ToolRegistry for context-aware tool assembly. */
+    toolRegistry?: ToolRegistry;
+}
+export type ProgressPhase = "Observing..." | "Generating task..." | "Executing task..." | "Verifying result..." | "Skipped" | "Skipped (no state change)";
+export interface ProgressEvent {
+    /** 1-based iteration number */
+    iteration: number;
+    /** Maximum iterations configured */
+    maxIterations: number;
+    /** Current phase label */
+    phase: ProgressPhase;
+    /** Gap aggregate from latest gap calculation (undefined before first gap calc) */
+    gap?: number;
+    /** Average confidence across gap dimensions (undefined before first gap calc) */
+    confidence?: number;
+    /** Short description of the task being executed (undefined outside execute phase) */
+    taskDescription?: string;
+    /** Reason this iteration was skipped (undefined when not skipped) */
+    skipReason?: 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=contracts.d.ts.map

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

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

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

@@ -0,0 +1,40 @@
+export { makeEmptyIterationResult } from "../loop-result-types.js";
+// ─── 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();
+    const deadlineTime = goal.deadline ? new Date(goal.deadline).getTime() : null;
+    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 (deadlineTime !== null) {
+            const hoursRemaining = (deadlineTime - now) / (1000 * 60 * 60);
+            deadlines[dim.name] = hoursRemaining;
+        }
+        else {
+            deadlines[dim.name] = null;
+        }
+    }
+    return {
+        time_since_last_attempt: timeSinceLastAttempt,
+        deadlines,
+        opportunities,
+        pacing: {},
+    };
+}
+//# sourceMappingURL=contracts.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"contracts.js","sourceRoot":"","sources":["../../../../src/orchestrator/loop/core-loop/contracts.ts"],"names":[],"mappings":"AAmCA,OAAO,EAAE,wBAAwB,EAAE,MAAM,yBAAyB,CAAC;AAiPnE,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;IACvB,MAAM,YAAY,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;IAE9E,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,YAAY,KAAK,IAAI,EAAE,CAAC;YAC1B,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;QACb,MAAM,EAAE,EAAE;KACX,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,27 @@
+import type { Logger } from "../../../runtime/logger.js";
+import type { StateDiffCalculator, IterationSnapshot } from "../state-diff.js";
+import type { ResolvedLoopConfig, LoopIterationResult, CoreLoopDeps } from "./contracts.js";
+import type { Goal } from "../../../base/types/goal.js";
+export interface StateDiffState {
+    previousSnapshot: IterationSnapshot | null;
+    consecutiveSkips: number;
+}
+/**
+ * Runs the state diff check for a loop iteration.
+ *
+ * Returns an object indicating whether to skip the rest of the iteration.
+ * When `shouldSkip` is true, `result` has been fully populated with skip info
+ * and the caller should return it immediately.
+ * When `shouldSkip` is false, the loop should continue normally.
+ */
+export declare function runStateDiffCheck(stateDiff: StateDiffCalculator, stateDiffStateMap: Map<string, StateDiffState>, goalId: string, goal: Goal, loopIndex: number, config: ResolvedLoopConfig, deps: CoreLoopDeps, result: LoopIterationResult, startTime: number, logger?: Logger): Promise<{
+    shouldSkip: boolean;
+}>;
+/**
+ * Attempts to run the iteration in parallel (TaskGroup mode).
+ *
+ * Returns `true` if the parallel path was taken (caller should return result),
+ * `false` if parallel was skipped/unavailable (fall through to normal task cycle).
+ */
+export declare function tryParallelExecution(goalId: string, goal: Goal, gapAggregate: number, result: LoopIterationResult, startTime: number, deps: CoreLoopDeps, loopIndex: number, logger?: Logger): Promise<boolean>;
+//# sourceMappingURL=control.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"control.d.ts","sourceRoot":"","sources":["../../../../src/orchestrator/loop/core-loop/control.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,4BAA4B,CAAC;AACzD,OAAO,KAAK,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAG/E,OAAO,KAAK,EACV,kBAAkB,EAClB,mBAAmB,EACnB,YAAY,EACb,MAAM,gBAAgB,CAAC;AACxB,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,6BAA6B,CAAC;AAIxD,MAAM,WAAW,cAAc;IAC7B,gBAAgB,EAAE,iBAAiB,GAAG,IAAI,CAAC;IAC3C,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAED;;;;;;;GAOG;AACH,wBAAsB,iBAAiB,CACrC,SAAS,EAAE,mBAAmB,EAC9B,iBAAiB,EAAE,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC,EAC9C,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,IAAI,EACV,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,kBAAkB,EAC1B,IAAI,EAAE,YAAY,EAClB,MAAM,EAAE,mBAAmB,EAC3B,SAAS,EAAE,MAAM,EACjB,MAAM,CAAC,EAAE,MAAM,GACd,OAAO,CAAC;IAAE,UAAU,EAAE,OAAO,CAAA;CAAE,CAAC,CAgDlC;AAID;;;;;GAKG;AACH,wBAAsB,oBAAoB,CACxC,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,IAAI,EACV,YAAY,EAAE,MAAM,EACpB,MAAM,EAAE,mBAAmB,EAC3B,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,YAAY,EAClB,SAAS,EAAE,MAAM,EACjB,MAAM,CAAC,EAAE,MAAM,GACd,OAAO,CAAC,OAAO,CAAC,CAclB"}

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

@@ -0,0 +1,72 @@
+import { tryRunParallel } from "../parallel-dispatch.js";
+import { generateLoopReport } from "../loop-report-helper.js";
+/**
+ * Runs the state diff check for a loop iteration.
+ *
+ * Returns an object indicating whether to skip the rest of the iteration.
+ * When `shouldSkip` is true, `result` has been fully populated with skip info
+ * and the caller should return it immediately.
+ * When `shouldSkip` is false, the loop should continue normally.
+ */
+export async function runStateDiffCheck(stateDiff, stateDiffStateMap, goalId, goal, loopIndex, config, deps, result, startTime, logger) {
+    const diffState = stateDiffStateMap.get(goalId) ?? { previousSnapshot: null, consecutiveSkips: 0 };
+    const snapshot = stateDiff.buildSnapshot(goal, loopIndex);
+    const diff = stateDiff.compare(diffState.previousSnapshot, snapshot);
+    diffState.previousSnapshot = snapshot;
+    if (!diff.hasChange && diffState.consecutiveSkips < config.maxConsecutiveSkips) {
+        diffState.consecutiveSkips++;
+        stateDiffStateMap.set(goalId, diffState);
+        logger?.info(`[CoreLoop] iteration ${loopIndex} skipped: no state change detected ` +
+            `(consecutiveSkips=${diffState.consecutiveSkips}/${config.maxConsecutiveSkips})`, { goalId });
+        result.skipped = true;
+        result.skipReason = "no_state_change";
+        deps.onProgress?.({
+            iteration: loopIndex + 1,
+            maxIterations: config.maxIterations,
+            phase: "Skipped",
+            skipReason: result.skipReason,
+        });
+        // Carry forward completion status from the already-loaded goal so a
+        // completed goal is not forced through 5 more iterations.
+        const goalState = await deps.stateManager.loadGoal(goalId);
+        if (goalState?.status === "completed") {
+            result.completionJudgment.is_complete = true;
+        }
+        deps.onProgress?.({
+            iteration: loopIndex + 1,
+            maxIterations: config.maxIterations,
+            phase: "Skipped (no state change)",
+        });
+        result.elapsedMs = Date.now() - startTime;
+        return { shouldSkip: true };
+    }
+    // Reset skip counter — full loop is running
+    diffState.consecutiveSkips = 0;
+    stateDiffStateMap.set(goalId, diffState);
+    if (!diff.hasChange) {
+        logger?.info(`[CoreLoop] max consecutive skips reached (${config.maxConsecutiveSkips}), ` +
+            "forcing full iteration for stall detection", { goalId });
+    }
+    return { shouldSkip: false };
+}
+// ─── Parallel execution check ───
+/**
+ * Attempts to run the iteration in parallel (TaskGroup mode).
+ *
+ * Returns `true` if the parallel path was taken (caller should return result),
+ * `false` if parallel was skipped/unavailable (fall through to normal task cycle).
+ */
+export async function tryParallelExecution(goalId, goal, gapAggregate, result, startTime, deps, loopIndex, logger) {
+    if (!deps.parallelExecutor || !deps.generateTaskGroupFn) {
+        return false;
+    }
+    const parallelResult = await tryRunParallel(goalId, goal, gapAggregate, result, startTime, deps, logger);
+    if (parallelResult !== null) {
+        // Parallel path completed — skip normal task cycle
+        await generateLoopReport(goalId, loopIndex, result, goal, deps.reportingEngine, logger);
+        result.elapsedMs = Date.now() - startTime;
+        return true;
+    }
+    return false;
+}
+//# sourceMappingURL=control.js.map

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

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