conatus 0.1.0

package/dist/strategy/cross-goal-portfolio.d.ts

@@ -0,0 +1,118 @@
+import { StateManager } from "../state-manager.js";
+import { GoalDependencyGraph } from "../goal/goal-dependency-graph.js";
+import { VectorIndex } from "../knowledge/vector-index.js";
+import type { IEmbeddingClient } from "../knowledge/embedding-client.js";
+import type { CrossGoalAllocation, CrossGoalPortfolioConfig, GoalPriorityFactors, StrategyTemplate, CrossGoalRebalanceResult, CrossGoalRebalanceTrigger, MomentumInfo, DependencySchedule, AllocationStrategy, RebalanceAction } from "../types/cross-portfolio.js";
+/**
+ * CrossGoalPortfolio manages resource allocation and priority across multiple
+ * active goals. It sits above individual PortfolioManager instances and answers
+ * the question: "given N active goals, how should overall resources be split?"
+ *
+ * Responsibilities:
+ *   - Calculate per-goal priority scores from 4 factors
+ *   - Allocate resource shares proportionally
+ *   - Rebalance on 4 trigger types
+ *   - Recommend strategy templates using vector similarity
+ *
+ * CrossGoalPortfolio does NOT manage strategies within a single goal —
+ * that remains the responsibility of PortfolioManager.
+ */
+export declare class CrossGoalPortfolio {
+    private readonly stateManager;
+    private readonly goalDependencyGraph;
+    private readonly vectorIndex;
+    private readonly embeddingClient;
+    private readonly config;
+    /** goalId → cached GoalPriorityFactors from the last calculation */
+    private lastPriorities;
+    constructor(stateManager: StateManager, goalDependencyGraph: GoalDependencyGraph, vectorIndex: VectorIndex, embeddingClient: IEmbeddingClient, config?: Partial<CrossGoalPortfolioConfig>);
+    /**
+     * Calculate priority factors for each goal in the provided list.
+     *
+     * The 4 factors and their weights:
+     *   w1=0.35  deadline_urgency    — how soon the goal must be finished
+     *   w2=0.25  gap_severity        — worst-case normalized gap across dimensions
+     *   w3=0.25  dependency_weight   — how many goals depend on this one
+     *   w4=0.15  user_priority       — user-specified priority (1-5 → 0-1)
+     *
+     * After the weighted sum is computed, synergy/conflict edges from
+     * GoalDependencyGraph adjust the final score before clamping to [0,1].
+     *
+     * @param goalIds — IDs of goals to evaluate (missing goals are skipped)
+     * @returns GoalPriorityFactors[] sorted by computed_priority descending
+     */
+    calculateGoalPriorities(goalIds: string[]): Promise<GoalPriorityFactors[]>;
+    /**
+     * Allocate resource shares across goals based on their priority scores.
+     * Delegates to the standalone allocateResources function.
+     */
+    allocateResources(priorities: GoalPriorityFactors[], strategy?: AllocationStrategy, momentumMap?: Map<string, MomentumInfo>, depSchedule?: DependencySchedule): CrossGoalAllocation[];
+    /**
+     * Recalculate priorities for all currently active goals and produce a new
+     * allocation plan.
+     *
+     * @param trigger — what caused this rebalance
+     * @param goalIds — explicit list of goal IDs to consider; if omitted, the
+     *                  IDs from the last calculateGoalPriorities call are used
+     */
+    rebalanceGoals(trigger: CrossGoalRebalanceTrigger, goalIds?: string[]): Promise<CrossGoalRebalanceResult>;
+    /**
+     * Search the VectorIndex for strategy templates that match the given goal.
+     *
+     * Matching is based on:
+     *   1. Semantic similarity between the goal text and template hypothesis_pattern
+     *   2. domain_tags overlap (at least 1 tag in common with the goal's domain tags)
+     *   3. Final ranking: similarity × effectiveness_score (descending)
+     *
+     * The caller is responsible for having added StrategyTemplate objects to the
+     * VectorIndex with their `template_id` as the entry id and metadata shaped
+     * as StrategyTemplate fields.
+     *
+     * @param goalId — goal for which templates are requested
+     * @param vectorIndex — the index to search (typically the instance-level one,
+     *                      but callers may pass a different one for testing)
+     * @param limit — number of results to return (default 3)
+     */
+    getRecommendedTemplates(goalId: string, vectorIndex: VectorIndex, limit?: number): Promise<StrategyTemplate[]>;
+    /**
+     * Calculate momentum for a single goal based on recent state snapshots.
+     * Delegates to the standalone calculateMomentum function.
+     */
+    calculateMomentum(goalId: string, snapshots: number[]): MomentumInfo;
+    /**
+     * Build a phased dependency schedule for the given goals.
+     * Delegates to the standalone buildDependencySchedule function.
+     */
+    buildDependencySchedule(goalIds: string[], graph: GoalDependencyGraph): DependencySchedule;
+    /**
+     * Detect stalled goals and redistribute their resources to progressing goals.
+     * Delegates to the standalone rebalanceOnStall function.
+     */
+    rebalanceOnStall(currentAllocations: CrossGoalAllocation[], momentumMap: Map<string, MomentumInfo>): RebalanceAction[];
+    /**
+     * Produce a rough [0,1] severity for a single goal dimension.
+     *
+     * For numeric thresholds we compute gap / scale.
+     * For binary thresholds (present/match) we return 0 or 1.
+     * Returns 0 when the dimension is already satisfied.
+     */
+    private _estimateDimensionGap;
+    /**
+     * Extract domain tags from a goal's constraints and title.
+     * Recognises constraints with format "domain:tagname" or "tag:tagname".
+     */
+    private _extractDomainTags;
+    /**
+     * Get a goal_id → resource_share map for the given goal IDs.
+     *
+     * Recomputes allocations based on current goal states.
+     * Returns a Map suitable for use by PortfolioManager.selectNextStrategyAcrossGoals().
+     */
+    getAllocationMap(goalIds: string[]): Promise<Map<string, number>>;
+}
+export { buildDependencySchedule } from "./portfolio-scheduling.js";
+export { computeCriticalPath } from "./portfolio-scheduling.js";
+export { allocateResources, rebalanceOnStall } from "./portfolio-allocation.js";
+export type { AllocationConfig } from "./portfolio-allocation.js";
+export { calculateMomentum } from "./portfolio-momentum.js";
+//# sourceMappingURL=cross-goal-portfolio.d.ts.map

package/dist/strategy/cross-goal-portfolio.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cross-goal-portfolio.d.ts","sourceRoot":"","sources":["../../src/strategy/cross-goal-portfolio.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAC;AACvE,OAAO,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAC3D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AAKzE,OAAO,KAAK,EACV,mBAAmB,EACnB,wBAAwB,EACxB,mBAAmB,EACnB,gBAAgB,EAChB,wBAAwB,EACxB,yBAAyB,EACzB,YAAY,EACZ,kBAAkB,EAClB,kBAAkB,EAClB,eAAe,EAChB,MAAM,6BAA6B,CAAC;AAarC;;;;;;;;;;;;;GAaG;AACH,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAe;IAC5C,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAsB;IAC1D,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAc;IAC1C,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAmB;IACnD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA2B;IAElD,oEAAoE;IACpE,OAAO,CAAC,cAAc,CAA+C;gBAGnE,YAAY,EAAE,YAAY,EAC1B,mBAAmB,EAAE,mBAAmB,EACxC,WAAW,EAAE,WAAW,EACxB,eAAe,EAAE,gBAAgB,EACjC,MAAM,CAAC,EAAE,OAAO,CAAC,wBAAwB,CAAC;IAW5C;;;;;;;;;;;;;;OAcG;IACG,uBAAuB,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,mBAAmB,EAAE,CAAC;IA+KhF;;;OAGG;IACH,iBAAiB,CACf,UAAU,EAAE,mBAAmB,EAAE,EACjC,QAAQ,CAAC,EAAE,kBAAkB,EAC7B,WAAW,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,YAAY,CAAC,EACvC,WAAW,CAAC,EAAE,kBAAkB,GAC/B,mBAAmB,EAAE;IAMxB;;;;;;;OAOG;IACG,cAAc,CAClB,OAAO,EAAE,yBAAyB,EAClC,OAAO,CAAC,EAAE,MAAM,EAAE,GACjB,OAAO,CAAC,wBAAwB,CAAC;IAcpC;;;;;;;;;;;;;;;;OAgBG;IACG,uBAAuB,CAC3B,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,WAAW,EACxB,KAAK,GAAE,MAAU,GAChB,OAAO,CAAC,gBAAgB,EAAE,CAAC;IA6E9B;;;OAGG;IACH,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,YAAY;IAMpE;;;OAGG;IACH,uBAAuB,CACrB,OAAO,EAAE,MAAM,EAAE,EACjB,KAAK,EAAE,mBAAmB,GACzB,kBAAkB;IAMrB;;;OAGG;IACH,gBAAgB,CACd,kBAAkB,EAAE,mBAAmB,EAAE,EACzC,WAAW,EAAE,GAAG,CAAC,MAAM,EAAE,YAAY,CAAC,GACrC,eAAe,EAAE;IAMpB;;;;;;OAMG;IACH,OAAO,CAAC,qBAAqB;IA4C7B;;;OAGG;IACH,OAAO,CAAC,kBAAkB;IAa1B;;;;;OAKG;IACG,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAmBxE;AAGD,OAAO,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AACpE,OAAO,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAChE,OAAO,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAChF,YAAY,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAClE,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC"}

package/dist/strategy/cross-goal-portfolio.js

@@ -0,0 +1,431 @@
+import { scoreDeadline } from "../drive/drive-scorer.js";
+import { CrossGoalPortfolioConfigSchema, } from "../types/cross-portfolio.js";
+import { buildDependencySchedule } from "./portfolio-scheduling.js";
+import { allocateResources } from "./portfolio-allocation.js";
+import { calculateMomentum } from "./portfolio-momentum.js";
+import { rebalanceOnStall } from "./portfolio-allocation.js";
+// ─── Helpers ───
+function clamp(value, min, max) {
+    return Math.min(Math.max(value, min), max);
+}
+/**
+ * CrossGoalPortfolio manages resource allocation and priority across multiple
+ * active goals. It sits above individual PortfolioManager instances and answers
+ * the question: "given N active goals, how should overall resources be split?"
+ *
+ * Responsibilities:
+ *   - Calculate per-goal priority scores from 4 factors
+ *   - Allocate resource shares proportionally
+ *   - Rebalance on 4 trigger types
+ *   - Recommend strategy templates using vector similarity
+ *
+ * CrossGoalPortfolio does NOT manage strategies within a single goal —
+ * that remains the responsibility of PortfolioManager.
+ */
+export class CrossGoalPortfolio {
+    stateManager;
+    goalDependencyGraph;
+    vectorIndex;
+    embeddingClient;
+    config;
+    /** goalId → cached GoalPriorityFactors from the last calculation */
+    lastPriorities = new Map();
+    constructor(stateManager, goalDependencyGraph, vectorIndex, embeddingClient, config) {
+        this.stateManager = stateManager;
+        this.goalDependencyGraph = goalDependencyGraph;
+        this.vectorIndex = vectorIndex;
+        this.embeddingClient = embeddingClient;
+        this.config = CrossGoalPortfolioConfigSchema.parse(config ?? {});
+    }
+    // ─── Priority Calculation ───
+    /**
+     * Calculate priority factors for each goal in the provided list.
+     *
+     * The 4 factors and their weights:
+     *   w1=0.35  deadline_urgency    — how soon the goal must be finished
+     *   w2=0.25  gap_severity        — worst-case normalized gap across dimensions
+     *   w3=0.25  dependency_weight   — how many goals depend on this one
+     *   w4=0.15  user_priority       — user-specified priority (1-5 → 0-1)
+     *
+     * After the weighted sum is computed, synergy/conflict edges from
+     * GoalDependencyGraph adjust the final score before clamping to [0,1].
+     *
+     * @param goalIds — IDs of goals to evaluate (missing goals are skipped)
+     * @returns GoalPriorityFactors[] sorted by computed_priority descending
+     */
+    async calculateGoalPriorities(goalIds) {
+        if (goalIds.length === 0)
+            return [];
+        const totalGoals = goalIds.length;
+        const now = new Date();
+        const rawList = [];
+        for (const goalId of goalIds) {
+            const goal = await this.stateManager.loadGoal(goalId);
+            if (!goal)
+                continue;
+            // deadline_urgency — use scoreDeadline with maxGap=1 as the
+            // normalized_weighted_gap input, then read the urgency value.
+            let deadlineUrgency = 0;
+            if (goal.deadline) {
+                const deadlineMs = new Date(goal.deadline).getTime();
+                const timeRemainingHours = (deadlineMs - now.getTime()) / (1000 * 60 * 60);
+                const result = scoreDeadline(1, timeRemainingHours);
+                // Normalize urgency to [0,1]. scoreDeadline with gap=1 means score == urgency.
+                // urgency >= 1 (at minimum). We normalise by capping at the urgency-at-zero cap.
+                // Use urgency directly but clamp to [0,1] after dividing by a reasonable max.
+                // default urgency_steepness=2, deadline_horizon=168h → urgencyAtZero = exp(2) ≈ 7.39
+                const urgencyAtZero = Math.exp(2); // exp(urgency_steepness)
+                deadlineUrgency = clamp(result.urgency / urgencyAtZero, 0, 1);
+            }
+            // gap_severity — max normalized_weighted_gap across all dimensions
+            // We approximate by treating each dimension's gap as proportional
+            // to how far it is from its threshold relative to a known scale.
+            // For simplicity (no GapCalculator instance injected), we derive a
+            // rough severity from the dimension values directly.
+            let gapSeverity = 0;
+            for (const dim of goal.dimensions) {
+                const dimGap = this._estimateDimensionGap(dim);
+                if (dimGap > gapSeverity) {
+                    gapSeverity = dimGap;
+                }
+            }
+            gapSeverity = clamp(gapSeverity, 0, 1);
+            // dependency_weight — how many goals in the provided list depend on this goal
+            const graph = this.goalDependencyGraph.getGraph();
+            const dependentCount = graph.edges.filter((e) => e.from_goal_id === goalId &&
+                e.type === "prerequisite" &&
+                e.status === "active" &&
+                goalIds.includes(e.to_goal_id)).length;
+            const dependencyWeight = totalGoals > 1 ? dependentCount / (totalGoals - 1) : 0;
+            // user_priority — extract from goal constraints or metadata
+            // Assume format "priority:N" (N in 1-5) anywhere in constraints
+            let userPriority = 0.5; // default
+            for (const constraint of goal.constraints) {
+                const match = constraint.match(/\bpriority[:\s=]+(\d+)\b/i);
+                if (match) {
+                    const level = parseInt(match[1], 10);
+                    userPriority = clamp(level / 5, 0, 1);
+                    break;
+                }
+            }
+            rawList.push({
+                goalId,
+                goal,
+                deadlineUrgency,
+                gapSeverity,
+                dependencyWeight: clamp(dependencyWeight, 0, 1),
+                userPriority,
+            });
+        }
+        if (rawList.length === 0)
+            return [];
+        // --- Step 2: compute weighted priority ---
+        const W1 = 0.35;
+        const W2 = 0.25;
+        const W3 = 0.25;
+        const W4 = 0.15;
+        const withBase = rawList.map((r) => {
+            const basePriority = W1 * r.deadlineUrgency +
+                W2 * r.gapSeverity +
+                W3 * r.dependencyWeight +
+                W4 * r.userPriority;
+            return { ...r, basePriority };
+        });
+        // --- Step 3: apply synergy / conflict adjustments ---
+        const synergyBonus = this.config.synergy_bonus / 2; // split the config bonus equally
+        const CONFLICT_PENALTY = 0.15;
+        const goalIdSet = new Set(rawList.map((r) => r.goalId));
+        // Build a lookup: goalId → index in withBase
+        const indexMap = new Map();
+        withBase.forEach((r, i) => indexMap.set(r.goalId, i));
+        // Adjust scores based on dependency edges between goals in the set
+        const adjustments = new Array(withBase.length).fill(0);
+        const graph = this.goalDependencyGraph.getGraph();
+        const seenPairs = new Set();
+        for (const edge of graph.edges) {
+            if (edge.status !== "active")
+                continue;
+            if (!goalIdSet.has(edge.from_goal_id) || !goalIdSet.has(edge.to_goal_id))
+                continue;
+            const pairKey = [edge.from_goal_id, edge.to_goal_id].sort().join("||");
+            if (edge.type === "synergy") {
+                if (!seenPairs.has(pairKey)) {
+                    seenPairs.add(pairKey);
+                    const idxA = indexMap.get(edge.from_goal_id);
+                    const idxB = indexMap.get(edge.to_goal_id);
+                    if (idxA !== undefined && adjustments[idxA] !== undefined)
+                        adjustments[idxA] += synergyBonus;
+                    if (idxB !== undefined && adjustments[idxB] !== undefined)
+                        adjustments[idxB] += synergyBonus;
+                }
+            }
+            else if (edge.type === "conflict") {
+                if (!seenPairs.has(pairKey)) {
+                    seenPairs.add(pairKey);
+                    // Penalise the lower-priority goal
+                    const idxA = indexMap.get(edge.from_goal_id);
+                    const idxB = indexMap.get(edge.to_goal_id);
+                    if (idxA !== undefined && idxB !== undefined) {
+                        const scoreA = withBase[idxA]?.basePriority ?? 0;
+                        const scoreB = withBase[idxB]?.basePriority ?? 0;
+                        if (scoreA <= scoreB) {
+                            if (adjustments[idxA] !== undefined)
+                                adjustments[idxA] -= CONFLICT_PENALTY;
+                        }
+                        else {
+                            if (adjustments[idxB] !== undefined)
+                                adjustments[idxB] -= CONFLICT_PENALTY;
+                        }
+                    }
+                }
+            }
+        }
+        // --- Step 4: produce final factors ---
+        const result = withBase.map((r, i) => {
+            const computedPriority = clamp(r.basePriority + (adjustments[i] ?? 0), 0, 1);
+            return {
+                goal_id: r.goalId,
+                deadline_urgency: r.deadlineUrgency,
+                gap_severity: r.gapSeverity,
+                dependency_weight: r.dependencyWeight,
+                user_priority: r.userPriority,
+                computed_priority: computedPriority,
+            };
+        });
+        // Sort descending by computed_priority
+        result.sort((a, b) => b.computed_priority - a.computed_priority);
+        // Cache for rebalance
+        for (const f of result) {
+            this.lastPriorities.set(f.goal_id, f);
+        }
+        return result;
+    }
+    // ─── Resource Allocation ───
+    /**
+     * Allocate resource shares across goals based on their priority scores.
+     * Delegates to the standalone allocateResources function.
+     */
+    allocateResources(priorities, strategy, momentumMap, depSchedule) {
+        return allocateResources(priorities, this.config, strategy, momentumMap, depSchedule);
+    }
+    // ─── Rebalancing ───
+    /**
+     * Recalculate priorities for all currently active goals and produce a new
+     * allocation plan.
+     *
+     * @param trigger — what caused this rebalance
+     * @param goalIds — explicit list of goal IDs to consider; if omitted, the
+     *                  IDs from the last calculateGoalPriorities call are used
+     */
+    async rebalanceGoals(trigger, goalIds) {
+        const ids = goalIds ?? Array.from(this.lastPriorities.keys());
+        const priorities = await this.calculateGoalPriorities(ids);
+        const allocations = this.allocateResources(priorities);
+        return {
+            timestamp: new Date().toISOString(),
+            allocations,
+            triggered_by: trigger,
+        };
+    }
+    // ─── Template Recommendation ───
+    /**
+     * Search the VectorIndex for strategy templates that match the given goal.
+     *
+     * Matching is based on:
+     *   1. Semantic similarity between the goal text and template hypothesis_pattern
+     *   2. domain_tags overlap (at least 1 tag in common with the goal's domain tags)
+     *   3. Final ranking: similarity × effectiveness_score (descending)
+     *
+     * The caller is responsible for having added StrategyTemplate objects to the
+     * VectorIndex with their `template_id` as the entry id and metadata shaped
+     * as StrategyTemplate fields.
+     *
+     * @param goalId — goal for which templates are requested
+     * @param vectorIndex — the index to search (typically the instance-level one,
+     *                      but callers may pass a different one for testing)
+     * @param limit — number of results to return (default 3)
+     */
+    async getRecommendedTemplates(goalId, vectorIndex, limit = 3) {
+        const goal = await this.stateManager.loadGoal(goalId);
+        if (!goal)
+            return [];
+        // Build a query string from the goal
+        const queryText = [goal.title, goal.description, ...goal.constraints]
+            .filter(Boolean)
+            .join(" ");
+        if (!queryText.trim())
+            return [];
+        // Search index — retrieve more than `limit` so we can filter by domain_tags
+        const searchResults = await vectorIndex.search(queryText, limit * 5);
+        if (searchResults.length === 0)
+            return [];
+        // Derive goal domain tags from constraints (format "domain:tag") or title words
+        const goalDomainTags = this._extractDomainTags(goal);
+        // Filter and score
+        const scored = [];
+        for (const result of searchResults) {
+            const meta = result.metadata;
+            // Must have the required StrategyTemplate fields in metadata
+            if (typeof meta["template_id"] !== "string" ||
+                typeof meta["hypothesis_pattern"] !== "string" ||
+                !Array.isArray(meta["domain_tags"]) ||
+                typeof meta["effectiveness_score"] !== "number") {
+                continue;
+            }
+            const domainTags = meta["domain_tags"];
+            const effectivenessScore = meta["effectiveness_score"];
+            // Require at least 1 domain tag overlap — unless goal has no tags (then include all)
+            if (goalDomainTags.length > 0) {
+                const overlap = domainTags.filter((t) => goalDomainTags.includes(t)).length;
+                if (overlap < 1)
+                    continue;
+            }
+            const template = {
+                template_id: meta["template_id"],
+                source_goal_id: typeof meta["source_goal_id"] === "string"
+                    ? meta["source_goal_id"]
+                    : "",
+                source_strategy_id: typeof meta["source_strategy_id"] === "string"
+                    ? meta["source_strategy_id"]
+                    : "",
+                hypothesis_pattern: meta["hypothesis_pattern"],
+                domain_tags: domainTags,
+                effectiveness_score: effectivenessScore,
+                applicable_dimensions: Array.isArray(meta["applicable_dimensions"])
+                    ? meta["applicable_dimensions"]
+                    : [],
+                embedding_id: typeof meta["embedding_id"] === "string"
+                    ? meta["embedding_id"]
+                    : null,
+                created_at: typeof meta["created_at"] === "string"
+                    ? meta["created_at"]
+                    : new Date().toISOString(),
+            };
+            const finalScore = result.similarity * effectivenessScore;
+            scored.push({ template, finalScore });
+        }
+        // Sort by finalScore descending and return top `limit`
+        scored.sort((a, b) => b.finalScore - a.finalScore);
+        return scored.slice(0, limit).map((s) => s.template);
+    }
+    // ─── Momentum ───
+    /**
+     * Calculate momentum for a single goal based on recent state snapshots.
+     * Delegates to the standalone calculateMomentum function.
+     */
+    calculateMomentum(goalId, snapshots) {
+        return calculateMomentum(goalId, snapshots);
+    }
+    // ─── Dependency Scheduling ───
+    /**
+     * Build a phased dependency schedule for the given goals.
+     * Delegates to the standalone buildDependencySchedule function.
+     */
+    buildDependencySchedule(goalIds, graph) {
+        return buildDependencySchedule(goalIds, graph);
+    }
+    // ─── Stall Rebalancing ───
+    /**
+     * Detect stalled goals and redistribute their resources to progressing goals.
+     * Delegates to the standalone rebalanceOnStall function.
+     */
+    rebalanceOnStall(currentAllocations, momentumMap) {
+        return rebalanceOnStall(currentAllocations, momentumMap);
+    }
+    // ─── Private helpers ───
+    /**
+     * Produce a rough [0,1] severity for a single goal dimension.
+     *
+     * For numeric thresholds we compute gap / scale.
+     * For binary thresholds (present/match) we return 0 or 1.
+     * Returns 0 when the dimension is already satisfied.
+     */
+    _estimateDimensionGap(dim) {
+        const { current_value, threshold } = dim;
+        if (current_value === null)
+            return 1;
+        switch (threshold.type) {
+            case "min": {
+                if (typeof current_value !== "number")
+                    return 0;
+                const gap = threshold.value - current_value;
+                if (gap <= 0)
+                    return 0;
+                return threshold.value !== 0 ? clamp(gap / threshold.value, 0, 1) : 1;
+            }
+            case "max": {
+                if (typeof current_value !== "number")
+                    return 0;
+                const gap = current_value - threshold.value;
+                if (gap <= 0)
+                    return 0;
+                return threshold.value !== 0 ? clamp(gap / threshold.value, 0, 1) : 1;
+            }
+            case "range": {
+                if (typeof current_value !== "number")
+                    return 0;
+                const span = threshold.high - threshold.low;
+                if (current_value < threshold.low) {
+                    const gap = threshold.low - current_value;
+                    return span > 0 ? clamp(gap / span, 0, 1) : 1;
+                }
+                if (current_value > threshold.high) {
+                    const gap = current_value - threshold.high;
+                    return span > 0 ? clamp(gap / span, 0, 1) : 1;
+                }
+                return 0;
+            }
+            case "present": {
+                return current_value ? 0 : 1;
+            }
+            case "match": {
+                return current_value === threshold.value ? 0 : 1;
+            }
+            default:
+                return 0;
+        }
+    }
+    /**
+     * Extract domain tags from a goal's constraints and title.
+     * Recognises constraints with format "domain:tagname" or "tag:tagname".
+     */
+    _extractDomainTags(goal) {
+        const tags = [];
+        for (const constraint of goal.constraints) {
+            const match = constraint.match(/^(?:domain|tag)[:\s]+(.+)$/i);
+            if (match) {
+                tags.push(match[1]?.trim().toLowerCase() ?? "");
+            }
+        }
+        return tags;
+    }
+    // ─── Allocation Map ───
+    /**
+     * Get a goal_id → resource_share map for the given goal IDs.
+     *
+     * Recomputes allocations based on current goal states.
+     * Returns a Map suitable for use by PortfolioManager.selectNextStrategyAcrossGoals().
+     */
+    async getAllocationMap(goalIds) {
+        const priorities = await this.calculateGoalPriorities(goalIds);
+        const allocations = this.allocateResources(priorities);
+        const map = new Map();
+        for (const alloc of allocations) {
+            map.set(alloc.goal_id, alloc.resource_share);
+        }
+        // Fill in any goal IDs that were not computed (e.g. loadGoal returned null)
+        const equalShare = goalIds.length > 0 ? 1.0 / goalIds.length : 0;
+        for (const goalId of goalIds) {
+            if (!map.has(goalId)) {
+                map.set(goalId, equalShare);
+            }
+        }
+        return map;
+    }
+}
+// ─── Re-exports for backward compatibility ───
+export { buildDependencySchedule } from "./portfolio-scheduling.js";
+export { computeCriticalPath } from "./portfolio-scheduling.js";
+export { allocateResources, rebalanceOnStall } from "./portfolio-allocation.js";
+export { calculateMomentum } from "./portfolio-momentum.js";
+//# sourceMappingURL=cross-goal-portfolio.js.map

package/dist/strategy/cross-goal-portfolio.js.map

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

package/dist/strategy/portfolio-allocation.d.ts

@@ -0,0 +1,36 @@
+import type { CrossGoalAllocation, GoalPriorityFactors, MomentumInfo, DependencySchedule, AllocationStrategy, RebalanceAction } from "../types/cross-portfolio.js";
+export interface AllocationConfig {
+    max_concurrent_goals: number;
+    min_goal_share: number;
+}
+/**
+ * Allocate resource shares across goals based on their priority scores.
+ *
+ * Rules:
+ *   1. If goals > max_concurrent_goals, lowest priority goals get allocation=0
+ *      and are labelled "waiting".
+ *   2. Active goals (up to max_concurrent_goals) share 1.0 proportionally to
+ *      computed_priority, with a floor of min_goal_share.
+ *   3. Sum of active allocations = 1.0.
+ *
+ * @param priorities — output from calculateGoalPriorities
+ * @param config — allocation configuration (max_concurrent_goals, min_goal_share)
+ * @param strategy   — optional AllocationStrategy (default: 'priority')
+ * @param momentumMap — goalId → MomentumInfo, required when strategy.type === 'momentum'
+ * @param depSchedule — DependencySchedule, required when strategy.type === 'dependency_aware'
+ * @returns CrossGoalAllocation[] in the same order as priorities
+ */
+export declare function allocateResources(priorities: GoalPriorityFactors[], config: AllocationConfig, strategy?: AllocationStrategy, momentumMap?: Map<string, MomentumInfo>, depSchedule?: DependencySchedule): CrossGoalAllocation[];
+/**
+ * Detect stalled goals and redistribute their resources to progressing goals.
+ *
+ * A goal is considered stalled if its MomentumInfo.trend === 'stalled'.
+ * Resources from stalled goals are redistributed proportionally to
+ * non-stalled goals based on their velocity.
+ *
+ * @param currentAllocations — current CrossGoalAllocation array
+ * @param momentumMap — goalId → MomentumInfo
+ * @returns array of RebalanceActions taken (empty if no stalled goals)
+ */
+export declare function rebalanceOnStall(currentAllocations: CrossGoalAllocation[], momentumMap: Map<string, MomentumInfo>): RebalanceAction[];
+//# sourceMappingURL=portfolio-allocation.d.ts.map

package/dist/strategy/portfolio-allocation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"portfolio-allocation.d.ts","sourceRoot":"","sources":["../../src/strategy/portfolio-allocation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,mBAAmB,EACnB,mBAAmB,EACnB,YAAY,EACZ,kBAAkB,EAClB,kBAAkB,EAClB,eAAe,EAChB,MAAM,6BAA6B,CAAC;AAQrC,MAAM,WAAW,gBAAgB;IAC/B,oBAAoB,EAAE,MAAM,CAAC;IAC7B,cAAc,EAAE,MAAM,CAAC;CACxB;AAID;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,iBAAiB,CAC/B,UAAU,EAAE,mBAAmB,EAAE,EACjC,MAAM,EAAE,gBAAgB,EACxB,QAAQ,CAAC,EAAE,kBAAkB,EAC7B,WAAW,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,YAAY,CAAC,EACvC,WAAW,CAAC,EAAE,kBAAkB,GAC/B,mBAAmB,EAAE,CAmIvB;AAID;;;;;;;;;;GAUG;AACH,wBAAgB,gBAAgB,CAC9B,kBAAkB,EAAE,mBAAmB,EAAE,EACzC,WAAW,EAAE,GAAG,CAAC,MAAM,EAAE,YAAY,CAAC,GACrC,eAAe,EAAE,CA6DnB"}