pulseed 0.0.1 → 0.1.1

package/dist/loop/iteration-budget.d.ts

@@ -0,0 +1,39 @@
+import { z } from "zod";
+export declare const IterationBudgetSchema: z.ZodObject<{
+    total: z.ZodNumber;
+    consumed: z.ZodNumber;
+    per_node_limit: z.ZodOptional<z.ZodNumber>;
+    warning_thresholds: z.ZodDefault<z.ZodArray<z.ZodNumber, "many">>;
+}, "strip", z.ZodTypeAny, {
+    total: number;
+    consumed: number;
+    warning_thresholds: number[];
+    per_node_limit?: number | undefined;
+}, {
+    total: number;
+    consumed: number;
+    per_node_limit?: number | undefined;
+    warning_thresholds?: number[] | undefined;
+}>;
+export type IterationBudgetData = z.infer<typeof IterationBudgetSchema>;
+export declare class IterationBudget {
+    private _total;
+    private _consumed;
+    private _perNodeLimit;
+    private _warningThresholds;
+    private _emittedWarnings;
+    constructor(total: number, perNodeLimit?: number);
+    get total(): number;
+    get consumed(): number;
+    get remaining(): number;
+    get perNodeLimit(): number | undefined;
+    get exhausted(): boolean;
+    get utilizationRatio(): number;
+    consume(count?: number): {
+        allowed: boolean;
+        warnings: string[];
+    };
+    toJSON(): IterationBudgetData;
+    static fromJSON(data: IterationBudgetData): IterationBudget;
+}
+//# sourceMappingURL=iteration-budget.d.ts.map

package/dist/loop/iteration-budget.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"iteration-budget.d.ts","sourceRoot":"","sources":["../../src/loop/iteration-budget.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;EAKhC,CAAC;AACH,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAExE,qBAAa,eAAe;IAC1B,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,aAAa,CAAqB;IAC1C,OAAO,CAAC,kBAAkB,CAAW;IACrC,OAAO,CAAC,gBAAgB,CAA0B;gBAEtC,KAAK,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM;IAOhD,IAAI,KAAK,IAAI,MAAM,CAAwB;IAC3C,IAAI,QAAQ,IAAI,MAAM,CAA2B;IACjD,IAAI,SAAS,IAAI,MAAM,CAAyC;IAChE,IAAI,YAAY,IAAI,MAAM,GAAG,SAAS,CAA+B;IACrE,IAAI,SAAS,IAAI,OAAO,CAA0C;IAClE,IAAI,gBAAgB,IAAI,MAAM,CAAyC;IAEvE,OAAO,CAAC,KAAK,GAAE,MAAU,GAAG;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,QAAQ,EAAE,MAAM,EAAE,CAAA;KAAE;IAiBpE,MAAM,IAAI,mBAAmB;IAS7B,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,mBAAmB,GAAG,eAAe;CAM5D"}

package/dist/loop/iteration-budget.js

@@ -0,0 +1,57 @@
+import { z } from "zod";
+export const IterationBudgetSchema = z.object({
+    total: z.number().int().positive(),
+    consumed: z.number().int().min(0),
+    per_node_limit: z.number().int().positive().optional(),
+    warning_thresholds: z.array(z.number().min(0).max(1)).default([0.7, 0.9]),
+});
+export class IterationBudget {
+    _total;
+    _consumed;
+    _perNodeLimit;
+    _warningThresholds;
+    _emittedWarnings = new Set();
+    constructor(total, perNodeLimit) {
+        this._total = total;
+        this._consumed = 0;
+        this._perNodeLimit = perNodeLimit;
+        this._warningThresholds = [0.7, 0.9];
+    }
+    get total() { return this._total; }
+    get consumed() { return this._consumed; }
+    get remaining() { return this._total - this._consumed; }
+    get perNodeLimit() { return this._perNodeLimit; }
+    get exhausted() { return this._consumed >= this._total; }
+    get utilizationRatio() { return this._consumed / this._total; }
+    consume(count = 1) {
+        const warnings = [];
+        if (this._consumed + count > this._total) {
+            return { allowed: false, warnings: [`Budget exhausted: ${this._consumed}/${this._total} iterations consumed`] };
+        }
+        this._consumed += count;
+        if (this._emittedWarnings.size < this._warningThresholds.length) {
+            for (const threshold of this._warningThresholds) {
+                if (this.utilizationRatio >= threshold && !this._emittedWarnings.has(threshold)) {
+                    this._emittedWarnings.add(threshold);
+                    warnings.push(`Budget warning: ${Math.round(this.utilizationRatio * 100)}% consumed (${this._consumed}/${this._total})`);
+                }
+            }
+        }
+        return { allowed: true, warnings };
+    }
+    toJSON() {
+        return {
+            total: this._total,
+            consumed: this._consumed,
+            per_node_limit: this._perNodeLimit,
+            warning_thresholds: this._warningThresholds,
+        };
+    }
+    static fromJSON(data) {
+        const budget = new IterationBudget(data.total, data.per_node_limit);
+        budget._consumed = data.consumed;
+        budget._warningThresholds = data.warning_thresholds;
+        return budget;
+    }
+}
+//# sourceMappingURL=iteration-budget.js.map

package/dist/loop/iteration-budget.js.map

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

package/dist/loop/loop-report-helper.d.ts

@@ -0,0 +1,14 @@
+/**
+ * loop-report-helper.ts
+ *
+ * Helper to generate and save a per-iteration execution report inside CoreLoop.
+ */
+import type { Goal } from "../types/goal.js";
+import type { ReportingEngine, LoopIterationResult } from "./core-loop-types.js";
+import type { Logger } from "../runtime/logger.js";
+/**
+ * Generate and save an execution summary report for one iteration.
+ * Non-fatal: report generation failures are logged and swallowed.
+ */
+export declare function generateLoopReport(goalId: string, loopIndex: number, iterationResult: LoopIterationResult, goal: Goal, reportingEngine: ReportingEngine, logger: Logger | undefined): Promise<void>;
+//# sourceMappingURL=loop-report-helper.d.ts.map

package/dist/loop/loop-report-helper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loop-report-helper.d.ts","sourceRoot":"","sources":["../../src/loop/loop-report-helper.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAC7C,OAAO,KAAK,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AACjF,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAGnD;;;GAGG;AACH,wBAAsB,kBAAkB,CACtC,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,EACjB,eAAe,EAAE,mBAAmB,EACpC,IAAI,EAAE,IAAI,EACV,eAAe,EAAE,eAAe,EAChC,MAAM,EAAE,MAAM,GAAG,SAAS,GACzB,OAAO,CAAC,IAAI,CAAC,CA6Cf"}

package/dist/loop/loop-report-helper.js

@@ -0,0 +1,57 @@
+/**
+ * loop-report-helper.ts
+ *
+ * Helper to generate and save a per-iteration execution report inside CoreLoop.
+ */
+import { dimensionProgress } from "../drive/gap-calculator.js";
+/**
+ * Generate and save an execution summary report for one iteration.
+ * Non-fatal: report generation failures are logged and swallowed.
+ */
+export async function generateLoopReport(goalId, loopIndex, iterationResult, goal, reportingEngine, logger) {
+    try {
+        const observation = goal.dimensions.map((d) => {
+            const prog = dimensionProgress(d.current_value, d.threshold);
+            let progress;
+            if (prog !== null) {
+                progress = prog;
+            }
+            else if (typeof d.current_value === "number") {
+                progress = d.current_value;
+            }
+            else {
+                progress = 0;
+            }
+            return {
+                dimensionName: d.name,
+                progress,
+                confidence: d.confidence,
+            };
+        });
+        const taskResult = iterationResult.taskResult !== null
+            ? {
+                taskId: iterationResult.taskResult.task.id,
+                action: iterationResult.taskResult.action,
+                dimension: iterationResult.taskResult.task.primary_dimension,
+            }
+            : null;
+        const report = reportingEngine.generateExecutionSummary({
+            goalId,
+            loopIndex,
+            observation,
+            gapAggregate: iterationResult.gapAggregate,
+            taskResult,
+            stallDetected: iterationResult.stallDetected,
+            pivotOccurred: iterationResult.pivotOccurred,
+            elapsedMs: iterationResult.elapsedMs,
+        });
+        await reportingEngine.saveReport(report);
+    }
+    catch (err) {
+        logger?.warn("CoreLoop: report generation failed", {
+            goalId,
+            error: err instanceof Error ? err.message : String(err),
+        });
+    }
+}
+//# sourceMappingURL=loop-report-helper.js.map

package/dist/loop/loop-report-helper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"loop-report-helper.js","sourceRoot":"","sources":["../../src/loop/loop-report-helper.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,OAAO,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAE/D;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,MAAc,EACd,SAAiB,EACjB,eAAoC,EACpC,IAAU,EACV,eAAgC,EAChC,MAA0B;IAE1B,IAAI,CAAC;QACH,MAAM,WAAW,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;YAC5C,MAAM,IAAI,GAAG,iBAAiB,CAAC,CAAC,CAAC,aAAa,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC;YAC7D,IAAI,QAAgB,CAAC;YACrB,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;gBAClB,QAAQ,GAAG,IAAI,CAAC;YAClB,CAAC;iBAAM,IAAI,OAAO,CAAC,CAAC,aAAa,KAAK,QAAQ,EAAE,CAAC;gBAC/C,QAAQ,GAAG,CAAC,CAAC,aAAa,CAAC;YAC7B,CAAC;iBAAM,CAAC;gBACN,QAAQ,GAAG,CAAC,CAAC;YACf,CAAC;YACD,OAAO;gBACL,aAAa,EAAE,CAAC,CAAC,IAAI;gBACrB,QAAQ;gBACR,UAAU,EAAE,CAAC,CAAC,UAAU;aACzB,CAAC;QACJ,CAAC,CAAC,CAAC;QAEH,MAAM,UAAU,GACd,eAAe,CAAC,UAAU,KAAK,IAAI;YACjC,CAAC,CAAC;gBACE,MAAM,EAAE,eAAe,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE;gBAC1C,MAAM,EAAE,eAAe,CAAC,UAAU,CAAC,MAAM;gBACzC,SAAS,EAAE,eAAe,CAAC,UAAU,CAAC,IAAI,CAAC,iBAAiB;aAC7D;YACH,CAAC,CAAC,IAAI,CAAC;QAEX,MAAM,MAAM,GAAG,eAAe,CAAC,wBAAwB,CAAC;YACtD,MAAM;YACN,SAAS;YACT,WAAW;YACX,YAAY,EAAE,eAAe,CAAC,YAAY;YAC1C,UAAU;YACV,aAAa,EAAE,eAAe,CAAC,aAAa;YAC5C,aAAa,EAAE,eAAe,CAAC,aAAa;YAC5C,SAAS,EAAE,eAAe,CAAC,SAAS;SACrC,CAAC,CAAC;QACH,MAAM,eAAe,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;IAC3C,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,EAAE,IAAI,CAAC,oCAAoC,EAAE;YACjD,MAAM;YACN,KAAK,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;SACxD,CAAC,CAAC;IACL,CAAC;AACH,CAAC"}

package/dist/loop/parallel-dispatch.d.ts

@@ -0,0 +1,16 @@
+/**
+ * parallel-dispatch.ts
+ *
+ * Attempt TaskGroup decomposition and parallel execution.
+ *
+ * Returns a ParallelExecutionResult when the parallel path ran successfully,
+ * or null when the caller should fall through to the normal single-task cycle.
+ * Updates result.taskResult with a synthetic entry reflecting the parallel outcome.
+ */
+import type { Goal } from "../types/goal.js";
+import type { CoreLoopDeps } from "./core-loop-types.js";
+import type { LoopIterationResult } from "./core-loop-types.js";
+import type { ParallelExecutionResult } from "../execution/parallel-executor.js";
+import type { Logger } from "../runtime/logger.js";
+export declare function tryRunParallel(goalId: string, goal: Goal, gapAggregate: number, result: LoopIterationResult, startTime: number, deps: CoreLoopDeps, logger: Logger | undefined): Promise<ParallelExecutionResult | null>;
+//# sourceMappingURL=parallel-dispatch.d.ts.map

package/dist/loop/parallel-dispatch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parallel-dispatch.d.ts","sourceRoot":"","sources":["../../src/loop/parallel-dispatch.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAC7C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACzD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAChE,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,mCAAmC,CAAC;AACjF,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAEnD,wBAAsB,cAAc,CAClC,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,IAAI,EACV,YAAY,EAAE,MAAM,EACpB,MAAM,EAAE,mBAAmB,EAC3B,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,YAAY,EAClB,MAAM,EAAE,MAAM,GAAG,SAAS,GACzB,OAAO,CAAC,uBAAuB,GAAG,IAAI,CAAC,CAoGzC"}

package/dist/loop/parallel-dispatch.js

@@ -0,0 +1,103 @@
+/**
+ * parallel-dispatch.ts
+ *
+ * Attempt TaskGroup decomposition and parallel execution.
+ *
+ * Returns a ParallelExecutionResult when the parallel path ran successfully,
+ * or null when the caller should fall through to the normal single-task cycle.
+ * Updates result.taskResult with a synthetic entry reflecting the parallel outcome.
+ */
+export async function tryRunParallel(goalId, goal, gapAggregate, result, startTime, deps, logger) {
+    const { parallelExecutor, generateTaskGroupFn, adapterRegistry } = deps;
+    if (!parallelExecutor || !generateTaskGroupFn)
+        return null;
+    // Only attempt parallel decomposition for multi-dimension goals (heuristic for "large")
+    if (goal.dimensions.length < 2)
+        return null;
+    const topDimension = goal.dimensions[0]?.name ?? "";
+    const currentState = String(goal.dimensions[0]?.current_value ?? "unknown");
+    const availableAdapters = adapterRegistry?.listAdapters() ?? ["default"];
+    const contextBlock = deps.contextProvider
+        ? await deps.contextProvider(goalId, topDimension).catch(() => undefined)
+        : undefined;
+    let group = null;
+    try {
+        group = await generateTaskGroupFn({
+            goalDescription: goal.title ?? goal.id,
+            targetDimension: topDimension,
+            currentState,
+            gap: gapAggregate,
+            availableAdapters,
+            contextBlock,
+        });
+    }
+    catch (err) {
+        logger?.warn("CoreLoop: generateTaskGroupFn threw, falling back to single-task", {
+            goalId,
+            error: err instanceof Error ? err.message : String(err),
+        });
+        return null;
+    }
+    if (!group) {
+        // LLM chose not to decompose — fall through to normal flow
+        return null;
+    }
+    logger?.info("CoreLoop: TaskGroup detected, routing to ParallelExecutor", {
+        goalId,
+        subtaskCount: group.subtasks.length,
+    });
+    // Determine active strategy for feedback
+    let strategyId;
+    try {
+        const activeStrategy = await deps.strategyManager.getActiveStrategy(goalId);
+        strategyId = activeStrategy?.id;
+    }
+    catch (err) {
+        logger?.warn("CoreLoop: strategyManager.getActiveStrategy failed", {
+            goalId,
+            error: err instanceof Error ? err.message : String(err),
+        });
+    }
+    let parallelResult;
+    try {
+        parallelResult = await parallelExecutor.execute(group, { goalId, strategy_id: strategyId });
+    }
+    catch (err) {
+        logger?.error("CoreLoop: ParallelExecutor threw, falling back to single-task", {
+            goalId,
+            error: err instanceof Error ? err.message : String(err),
+        });
+        return null;
+    }
+    // Map parallel outcome to a synthetic TaskCycleResult so downstream
+    // logic (reporting, portfolio recording) can work without branching.
+    const syntheticTask = group.subtasks[0];
+    if (syntheticTask) {
+        const action = parallelResult.overall_verdict === "pass"
+            ? "completed"
+            : parallelResult.overall_verdict === "partial"
+                ? "keep"
+                : "escalate";
+        const confidence = parallelResult.overall_verdict === "pass" ? 0.9 : 0.4;
+        const now = new Date().toISOString();
+        result.taskResult = {
+            task: syntheticTask,
+            verificationResult: {
+                task_id: syntheticTask.id,
+                verdict: parallelResult.overall_verdict,
+                confidence,
+                evidence: parallelResult.results.map((r) => ({
+                    layer: "mechanical",
+                    description: r.output || `subtask ${r.task_id}: ${r.verdict}`,
+                    confidence,
+                })),
+                dimension_updates: [],
+                timestamp: now,
+            },
+            action,
+        };
+    }
+    result.elapsedMs = Date.now() - startTime;
+    return parallelResult;
+}
+//# sourceMappingURL=parallel-dispatch.js.map

package/dist/loop/parallel-dispatch.js.map

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

package/dist/loop/post-loop-hooks.d.ts

@@ -0,0 +1,27 @@
+/**
+ * post-loop-hooks.ts
+ *
+ * Post-loop side effects executed at the end of CoreLoop.run():
+ *   - Curiosity trigger evaluation
+ *   - Learning pipeline (goal completion)
+ *   - Memory lifecycle close
+ *   - Goal archive
+ *   - Final run report generation
+ */
+import type { CoreLoopDeps, ResolvedLoopConfig, LoopResult, LoopIterationResult } from "./core-loop-types.js";
+import type { Goal } from "../types/goal.js";
+import type { Logger } from "../runtime/logger.js";
+export interface PostLoopHooksParams {
+    goalId: string;
+    finalStatus: LoopResult["finalStatus"];
+    iterations: LoopIterationResult[];
+    deps: CoreLoopDeps;
+    config: ResolvedLoopConfig;
+    logger: Logger | undefined;
+    tryGenerateReport: (goalId: string, loopIndex: number, iterationResult: LoopIterationResult, goal: Goal) => Promise<void>;
+}
+/**
+ * Run all post-loop hooks in sequence. Each hook is non-fatal.
+ */
+export declare function runPostLoopHooks(params: PostLoopHooksParams): Promise<void>;
+//# sourceMappingURL=post-loop-hooks.d.ts.map

package/dist/loop/post-loop-hooks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"post-loop-hooks.d.ts","sourceRoot":"","sources":["../../src/loop/post-loop-hooks.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,kBAAkB,EAAE,UAAU,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAC9G,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAC7C,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAEnD,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,UAAU,CAAC,aAAa,CAAC,CAAC;IACvC,UAAU,EAAE,mBAAmB,EAAE,CAAC;IAClC,IAAI,EAAE,YAAY,CAAC;IACnB,MAAM,EAAE,kBAAkB,CAAC;IAC3B,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,iBAAiB,EAAE,CACjB,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,EACjB,eAAe,EAAE,mBAAmB,EACpC,IAAI,EAAE,IAAI,KACP,OAAO,CAAC,IAAI,CAAC,CAAC;CACpB;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CAAC,MAAM,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC,CAqFjF"}

package/dist/loop/post-loop-hooks.js

@@ -0,0 +1,99 @@
+/**
+ * post-loop-hooks.ts
+ *
+ * Post-loop side effects executed at the end of CoreLoop.run():
+ *   - Curiosity trigger evaluation
+ *   - Learning pipeline (goal completion)
+ *   - Memory lifecycle close
+ *   - Goal archive
+ *   - Final run report generation
+ */
+/**
+ * Run all post-loop hooks in sequence. Each hook is non-fatal.
+ */
+export async function runPostLoopHooks(params) {
+    const { goalId, finalStatus, iterations, deps, config, logger, tryGenerateReport } = params;
+    // Persist final status to disk before post-loop hooks
+    if (finalStatus === "completed" && !config.dryRun) {
+        try {
+            const goalState = await deps.stateManager.loadGoal(goalId);
+            if (goalState) {
+                goalState.status = "completed";
+                await deps.stateManager.saveGoal(goalState);
+            }
+        }
+        catch (err) {
+            logger?.warn("CoreLoop: failed to persist final status", {
+                goalId,
+                finalStatus,
+                error: err instanceof Error ? err.message : String(err),
+            });
+        }
+    }
+    // Curiosity trigger evaluation
+    if (deps.curiosityEngine && (finalStatus === "completed" || finalStatus === "max_iterations")) {
+        try {
+            deps.curiosityEngine.checkAutoExpiration();
+            const currentGoal = await deps.stateManager.loadGoal(goalId);
+            if (currentGoal) {
+                const allGoals = [currentGoal];
+                if (await deps.curiosityEngine.shouldExplore(allGoals)) {
+                    const triggers = await deps.curiosityEngine.evaluateTriggers(allGoals);
+                    if (triggers.length > 0) {
+                        await deps.curiosityEngine.generateProposals(triggers, allGoals);
+                    }
+                }
+            }
+        }
+        catch (err) {
+            logger?.warn("CoreLoop: curiosity evaluation failed", {
+                error: err instanceof Error ? err.message : String(err),
+            });
+        }
+    }
+    // Learning pipeline — goal completion callback handled by CoreLoopLearning caller
+    // (onGoalCompleted is called from CoreLoop.run() after this function, to keep
+    //  CoreLoopLearning state inside CoreLoop. This hook only handles non-learning side effects.)
+    // Memory lifecycle close on completion
+    if (deps.memoryLifecycleManager && finalStatus === "completed") {
+        try {
+            await deps.memoryLifecycleManager.onGoalClose(goalId, "completed");
+        }
+        catch (err) {
+            logger?.warn("CoreLoop: memoryLifecycleManager.onGoalClose failed", {
+                goalId,
+                error: err instanceof Error ? err.message : String(err),
+            });
+        }
+    }
+    // Archive goal state on completion (only when autoArchive is explicitly enabled)
+    if (finalStatus === "completed" && config.autoArchive && !config.dryRun) {
+        try {
+            await deps.stateManager.archiveGoal(goalId);
+        }
+        catch (err) {
+            logger?.warn("CoreLoop: stateManager.archiveGoal failed", {
+                goalId,
+                error: err instanceof Error ? err.message : String(err),
+            });
+        }
+    }
+    // Final run report for non-completed exits
+    if (finalStatus !== "completed" && iterations.length > 0) {
+        try {
+            const finalGoal = await deps.stateManager.loadGoal(goalId);
+            if (finalGoal) {
+                const lastIteration = iterations[iterations.length - 1];
+                await tryGenerateReport(goalId, lastIteration.loopIndex, lastIteration, finalGoal);
+            }
+        }
+        catch (err) {
+            logger?.warn("CoreLoop: final run report generation failed", {
+                goalId,
+                finalStatus,
+                error: err instanceof Error ? err.message : String(err),
+            });
+        }
+    }
+}
+//# sourceMappingURL=post-loop-hooks.js.map

package/dist/loop/post-loop-hooks.js.map

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

package/dist/loop/state-diff.d.ts

@@ -0,0 +1,41 @@
+import type { Goal } from "../types/goal.js";
+export interface StateDiffThresholds {
+    /** Absolute change in normalized value that counts as meaningful. Default: 0.05 */
+    value_delta: number;
+    /** Absolute change in confidence that counts as meaningful. Default: 0.10 */
+    confidence_delta: number;
+    /** Whether a change in observation layer counts as meaningful. Default: true */
+    layer_change: boolean;
+}
+export interface IterationSnapshot {
+    iteration: number;
+    timestamp: string;
+    dimensions: Record<string, {
+        current_value: number;
+        confidence: number;
+        observation_layer: string;
+    }>;
+}
+export interface StateDiffResult {
+    hasChange: boolean;
+    /** Names of dimensions that changed */
+    changedDimensions: string[];
+    /** Human-readable explanation */
+    reason?: string;
+}
+export declare class StateDiffCalculator {
+    private readonly thresholds;
+    constructor(thresholds?: Partial<StateDiffThresholds>);
+    /**
+     * Build a snapshot from the current goal state.
+     * current_value is coerced to a number (non-numeric values become 0).
+     */
+    buildSnapshot(goal: Goal, iteration: number): IterationSnapshot;
+    /**
+     * Compare two snapshots. Returns hasChange=true if any dimension changed
+     * meaningfully per the configured thresholds. When previous is null (first
+     * iteration) always returns hasChange=true.
+     */
+    compare(previous: IterationSnapshot | null, current: IterationSnapshot): StateDiffResult;
+}
+//# sourceMappingURL=state-diff.d.ts.map

package/dist/loop/state-diff.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"state-diff.d.ts","sourceRoot":"","sources":["../../src/loop/state-diff.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAI7C,MAAM,WAAW,mBAAmB;IAClC,mFAAmF;IACnF,WAAW,EAAE,MAAM,CAAC;IACpB,6EAA6E;IAC7E,gBAAgB,EAAE,MAAM,CAAC;IACzB,gFAAgF;IAChF,YAAY,EAAE,OAAO,CAAC;CACvB;AAED,MAAM,WAAW,iBAAiB;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAChB,MAAM,EACN;QACE,aAAa,EAAE,MAAM,CAAC;QACtB,UAAU,EAAE,MAAM,CAAC;QACnB,iBAAiB,EAAE,MAAM,CAAC;KAC3B,CACF,CAAC;CACH;AAED,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,OAAO,CAAC;IACnB,uCAAuC;IACvC,iBAAiB,EAAE,MAAM,EAAE,CAAC;IAC5B,iCAAiC;IACjC,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAYD,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAsB;gBAErC,UAAU,CAAC,EAAE,OAAO,CAAC,mBAAmB,CAAC;IAIrD;;;OAGG;IACH,aAAa,CAAC,IAAI,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,GAAG,iBAAiB;IA4B/D;;;;OAIG;IACH,OAAO,CACL,QAAQ,EAAE,iBAAiB,GAAG,IAAI,EAClC,OAAO,EAAE,iBAAiB,GACzB,eAAe;CAkDnB"}

package/dist/loop/state-diff.js

@@ -0,0 +1,86 @@
+// ─── Defaults ───
+const DEFAULT_THRESHOLDS = {
+    value_delta: 0.05,
+    confidence_delta: 0.10,
+    layer_change: true,
+};
+// ─── StateDiffCalculator ───
+export class StateDiffCalculator {
+    thresholds;
+    constructor(thresholds) {
+        this.thresholds = { ...DEFAULT_THRESHOLDS, ...thresholds };
+    }
+    /**
+     * Build a snapshot from the current goal state.
+     * current_value is coerced to a number (non-numeric values become 0).
+     */
+    buildSnapshot(goal, iteration) {
+        const dimensions = {};
+        for (const dim of goal.dimensions) {
+            const rawValue = dim.current_value;
+            const numericValue = typeof rawValue === "number"
+                ? rawValue
+                : typeof rawValue === "boolean"
+                    ? rawValue
+                        ? 1
+                        : 0
+                    : 0;
+            dimensions[dim.name] = {
+                current_value: numericValue,
+                confidence: dim.confidence,
+                observation_layer: dim.last_observed_layer ?? "self_report",
+            };
+        }
+        return {
+            iteration,
+            timestamp: new Date().toISOString(),
+            dimensions,
+        };
+    }
+    /**
+     * Compare two snapshots. Returns hasChange=true if any dimension changed
+     * meaningfully per the configured thresholds. When previous is null (first
+     * iteration) always returns hasChange=true.
+     */
+    compare(previous, current) {
+        if (previous === null) {
+            return { hasChange: true, changedDimensions: [], reason: "first iteration" };
+        }
+        const changedDimensions = [];
+        for (const [name, curr] of Object.entries(current.dimensions)) {
+            const prev = previous.dimensions[name];
+            // Dimension is new (not present in previous snapshot) — treat as changed
+            if (!prev) {
+                changedDimensions.push(name);
+                continue;
+            }
+            const valueDelta = Math.abs(curr.current_value - prev.current_value);
+            const confidenceDelta = Math.abs(curr.confidence - prev.confidence);
+            const layerChanged = curr.observation_layer !== prev.observation_layer;
+            if (valueDelta >= this.thresholds.value_delta ||
+                confidenceDelta >= this.thresholds.confidence_delta ||
+                (this.thresholds.layer_change && layerChanged)) {
+                changedDimensions.push(name);
+            }
+        }
+        // Reverse check: dimensions present in previous but absent in current
+        for (const name of Object.keys(previous.dimensions)) {
+            if (!(name in current.dimensions)) {
+                changedDimensions.push(name);
+            }
+        }
+        if (changedDimensions.length > 0) {
+            return {
+                hasChange: true,
+                changedDimensions,
+                reason: `changed dimensions: ${changedDimensions.join(", ")}`,
+            };
+        }
+        return {
+            hasChange: false,
+            changedDimensions: [],
+            reason: "no meaningful change across all dimensions",
+        };
+    }
+}
+//# sourceMappingURL=state-diff.js.map

package/dist/loop/state-diff.js.map

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

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

@@ -0,0 +1,24 @@
+import type { CoreLoopDeps, ResolvedLoopConfig, 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: ResolvedLoopConfig, logger: Logger | undefined, runOneIteration: (goalId: string, loopIndex: number) => Promise<LoopIterationResult>, nodeConsumedMap: Map<string, number>): 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: ResolvedLoopConfig, 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,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAElG,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAGnD;;;;;GAKG;AACH,wBAAsB,gBAAgB,CACpC,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,YAAY,EAClB,MAAM,EAAE,kBAAkB,EAC1B,MAAM,EAAE,MAAM,GAAG,SAAS,EAC1B,eAAe,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,KAAK,OAAO,CAAC,mBAAmB,CAAC,EACpF,eAAe,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GACnC,OAAO,CAAC,mBAAmB,CAAC,CAqH9B;AAED;;;;;;;;;;;;GAYG;AACH,wBAAsB,qBAAqB,CACzC,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,YAAY,EAClB,MAAM,EAAE,kBAAkB,EAC1B,eAAe,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,KAAK,OAAO,CAAC,mBAAmB,CAAC,GACnF,OAAO,CAAC,mBAAmB,CAAC,CA6C9B"}