pulseed 0.0.1 → 0.1.0

package/dist/state-manager.js

@@ -0,0 +1,523 @@
+import * as fsp from "node:fs/promises";
+import * as path from "node:path";
+import { getPulseedDirPath } from "./utils/paths.js";
+import { StateError } from "./utils/errors.js";
+import { writeJsonFileAtomic } from "./utils/json-io.js";
+import { GoalSchema, GoalTreeSchema } from "./types/goal.js";
+import { ObservationLogSchema, ObservationLogEntrySchema } from "./types/state.js";
+import { GapHistoryEntrySchema } from "./types/gap.js";
+import { LoopCheckpointSchema } from "./types/checkpoint.js";
+/**
+ * StateManager handles persistence of goals, state vectors, observation logs,
+ * and gap history under a base directory (default: ~/.pulseed/).
+ *
+ * File layout:
+ *   <base>/goals/<goal_id>/goal.json
+ *   <base>/goals/<goal_id>/observations.json
+ *   <base>/goals/<goal_id>/gap-history.json
+ *   <base>/goal-trees/<root_id>.json
+ *   <base>/events/              (event queue directory)
+ *   <base>/events/archive/      (processed events)
+ *   <base>/reports/             (report output directory)
+ *
+ * All writes are atomic: write to .tmp file, then rename.
+ */
+export class StateManager {
+    baseDir;
+    logger;
+    constructor(baseDir, logger) {
+        this.baseDir = baseDir ?? getPulseedDirPath();
+        this.logger = logger;
+    }
+    /** Create required subdirectories. Must be called after construction before first use. */
+    async init() {
+        const dirs = [
+            this.baseDir,
+            path.join(this.baseDir, "goals"),
+            path.join(this.baseDir, "goal-trees"),
+            path.join(this.baseDir, "events"),
+            path.join(this.baseDir, "events", "archive"),
+            path.join(this.baseDir, "reports"),
+            path.join(this.baseDir, "reports", "daily"),
+            path.join(this.baseDir, "reports", "weekly"),
+            path.join(this.baseDir, "reports", "notifications"),
+            path.join(this.baseDir, "checkpoints"),
+        ];
+        for (const dir of dirs) {
+            await fsp.mkdir(dir, { recursive: true });
+        }
+    }
+    /** Returns the base directory path */
+    getBaseDir() {
+        return this.baseDir;
+    }
+    async goalDir(goalId) {
+        const dir = path.join(this.baseDir, "goals", goalId);
+        try {
+            await fsp.mkdir(dir, { recursive: true });
+        }
+        catch (err) {
+            if (err.code === "ENOENT")
+                return dir;
+            throw err;
+        }
+        return dir;
+    }
+    // ─── Atomic Write ───
+    async atomicWrite(filePath, data) {
+        try {
+            await writeJsonFileAtomic(filePath, data);
+        }
+        catch (err) {
+            // Base dir removed (e.g. test cleanup) — silently skip write
+            if (err.code === "ENOENT")
+                return;
+            throw err;
+        }
+    }
+    async atomicRead(filePath) {
+        let content;
+        try {
+            content = await fsp.readFile(filePath, "utf-8");
+        }
+        catch (err) {
+            if (err.code === "ENOENT") {
+                return null;
+            }
+            throw err;
+        }
+        try {
+            return JSON.parse(content);
+        }
+        catch (err) {
+            this.logger?.warn(`[StateManager] Corrupt JSON at ${filePath}: ${err}`);
+            throw err;
+        }
+    }
+    // ─── Goal CRUD ───
+    async saveGoal(goal) {
+        const parsed = GoalSchema.parse(goal);
+        const dir = await this.goalDir(parsed.id);
+        await this.atomicWrite(path.join(dir, "goal.json"), parsed);
+    }
+    async loadGoal(goalId) {
+        // Primary path: active goals
+        const filePath = path.join(this.baseDir, "goals", goalId, "goal.json");
+        const raw = await this.atomicRead(filePath);
+        if (raw !== null)
+            return GoalSchema.parse(raw);
+        // Fallback: archived goals (archiveGoal() copies goal dir to archive/<goalId>/goal/)
+        const archivePath = path.join(this.baseDir, "archive", goalId, "goal", "goal.json");
+        const archiveRaw = await this.atomicRead(archivePath);
+        if (archiveRaw === null)
+            return null;
+        return GoalSchema.parse(archiveRaw);
+    }
+    async deleteGoal(goalId, _visited = new Set()) {
+        if (_visited.has(goalId))
+            return false;
+        _visited.add(goalId);
+        const dir = path.join(this.baseDir, "goals", goalId);
+        try {
+            await fsp.access(dir);
+        }
+        catch {
+            // After the active goals check fails, try archive directory
+            const archiveDir = path.join(this.baseDir, "archive", goalId);
+            try {
+                await fsp.access(archiveDir);
+                // Load archived goal to get children_ids before deleting
+                const archiveGoalPath = path.join(archiveDir, "goal", "goal.json");
+                let archivedGoal = null;
+                try {
+                    const raw = await this.atomicRead(archiveGoalPath);
+                    if (raw !== null)
+                        archivedGoal = GoalSchema.parse(raw);
+                }
+                catch {
+                    this.logger?.warn(`[StateManager] Skipping children of archived "${goalId}": goal.json unreadable`);
+                }
+                if (archivedGoal !== null) {
+                    for (const childId of archivedGoal.children_ids) {
+                        await this.deleteGoal(childId, _visited);
+                    }
+                }
+                await fsp.rm(archiveDir, { recursive: true, force: true });
+                return true;
+            }
+            catch {
+                return false;
+            }
+        }
+        // Recursively delete children first (depth-first)
+        let goal = null;
+        try {
+            goal = await this.loadGoal(goalId);
+        }
+        catch {
+            this.logger?.warn(`[StateManager] Skipping children of "${goalId}": goal.json unreadable`);
+        }
+        if (goal !== null) {
+            for (const childId of goal.children_ids) {
+                await this.deleteGoal(childId, _visited);
+            }
+        }
+        await fsp.rm(dir, { recursive: true, force: true });
+        return true;
+    }
+    /**
+     * Archive a completed goal by moving its state files to
+     * <base>/archive/<goalId>/.
+     *
+     * Moves:
+     *   goals/<goalId>/         → archive/<goalId>/goal/
+     *   tasks/<goalId>/         → archive/<goalId>/tasks/    (if exists)
+     *   strategies/<goalId>/    → archive/<goalId>/strategies/ (if exists)
+     *   stalls/<goalId>.json    → archive/<goalId>/stalls.json (if exists)
+     *   reports/<goalId>/       → archive/<goalId>/reports/  (if exists)
+     *
+     * Returns true if the goal was archived, false if the goal was not found.
+     */
+    async archiveGoal(goalId, _visited = new Set()) {
+        if (_visited.has(goalId))
+            return false;
+        _visited.add(goalId);
+        const goalDir = path.join(this.baseDir, "goals", goalId);
+        try {
+            await fsp.access(goalDir);
+        }
+        catch {
+            return false;
+        }
+        // Recursively archive children first (depth-first)
+        let goal = null;
+        try {
+            goal = await this.loadGoal(goalId);
+        }
+        catch {
+            this.logger?.warn(`[StateManager] Skipping children of "${goalId}": goal.json unreadable`);
+        }
+        if (goal !== null) {
+            for (const childId of goal.children_ids) {
+                await this.archiveGoal(childId, _visited);
+            }
+        }
+        const archiveBase = path.join(this.baseDir, "archive", goalId);
+        await fsp.mkdir(archiveBase, { recursive: true });
+        // Move goals/<goalId>/ → archive/<goalId>/goal/
+        const archiveGoalDir = path.join(archiveBase, "goal");
+        await fsp.cp(goalDir, archiveGoalDir, { recursive: true });
+        await fsp.rm(goalDir, { recursive: true, force: true });
+        // Update status to "archived" in the archived goal.json (Bug 5)
+        // Use direct JSON merge instead of GoalSchema.parse() to avoid silent failure
+        // when unrelated fields fail Zod validation, which would leave status as "active".
+        const archivedGoalJsonPath = path.join(archiveGoalDir, "goal.json");
+        try {
+            const archivedRaw = await this.atomicRead(archivedGoalJsonPath);
+            if (archivedRaw !== null && typeof archivedRaw === "object") {
+                await this.atomicWrite(archivedGoalJsonPath, { ...archivedRaw, status: "archived" });
+            }
+            else {
+                this.logger?.warn(`[StateManager] Could not update status to "archived" for "${goalId}": goal.json missing or not an object`);
+            }
+        }
+        catch (err) {
+            this.logger?.warn(`[StateManager] Could not update status to "archived" for "${goalId}": ${String(err)}`);
+        }
+        // Move tasks/<goalId>/ → archive/<goalId>/tasks/ (if exists)
+        const tasksDir = path.join(this.baseDir, "tasks", goalId);
+        try {
+            await fsp.access(tasksDir);
+            const archiveTasksDir = path.join(archiveBase, "tasks");
+            await fsp.cp(tasksDir, archiveTasksDir, { recursive: true });
+            await fsp.rm(tasksDir, { recursive: true, force: true });
+        }
+        catch { /* not found, skip */ }
+        // Move strategies/<goalId>/ → archive/<goalId>/strategies/ (if exists)
+        const strategiesDir = path.join(this.baseDir, "strategies", goalId);
+        try {
+            await fsp.access(strategiesDir);
+            const archiveStrategiesDir = path.join(archiveBase, "strategies");
+            await fsp.cp(strategiesDir, archiveStrategiesDir, { recursive: true });
+            await fsp.rm(strategiesDir, { recursive: true, force: true });
+        }
+        catch { /* not found, skip */ }
+        // Move stalls/<goalId>.json → archive/<goalId>/stalls.json (if exists)
+        const stallsFile = path.join(this.baseDir, "stalls", `${goalId}.json`);
+        try {
+            await fsp.access(stallsFile);
+            const archiveStallsFile = path.join(archiveBase, "stalls.json");
+            await fsp.cp(stallsFile, archiveStallsFile);
+            await fsp.rm(stallsFile, { force: true });
+        }
+        catch { /* not found, skip */ }
+        // Move reports/<goalId>/ → archive/<goalId>/reports/ (if exists)
+        const reportsDir = path.join(this.baseDir, "reports", goalId);
+        try {
+            await fsp.access(reportsDir);
+            const archiveReportsDir = path.join(archiveBase, "reports");
+            await fsp.cp(reportsDir, archiveReportsDir, { recursive: true });
+            await fsp.rm(reportsDir, { recursive: true, force: true });
+        }
+        catch { /* not found, skip */ }
+        return true;
+    }
+    /**
+     * Returns the goal IDs of all archived goals under <base>/archive/.
+     */
+    async listArchivedGoals() {
+        const archiveDir = path.join(this.baseDir, "archive");
+        try {
+            const entries = await fsp.readdir(archiveDir, { withFileTypes: true });
+            return entries.filter((d) => d.isDirectory()).map((d) => d.name);
+        }
+        catch {
+            return [];
+        }
+    }
+    async listGoalIds() {
+        const goalsDir = path.join(this.baseDir, "goals");
+        try {
+            const entries = await fsp.readdir(goalsDir, { withFileTypes: true });
+            return entries.filter((d) => d.isDirectory()).map((d) => d.name);
+        }
+        catch {
+            return [];
+        }
+    }
+    // ─── Goal Tree ───
+    async saveGoalTree(tree) {
+        const parsed = GoalTreeSchema.parse(tree);
+        const filePath = path.join(this.baseDir, "goal-trees", `${parsed.root_id}.json`);
+        await this.atomicWrite(filePath, parsed);
+    }
+    async loadGoalTree(rootId) {
+        const filePath = path.join(this.baseDir, "goal-trees", `${rootId}.json`);
+        const raw = await this.atomicRead(filePath);
+        if (raw === null)
+            return null;
+        return GoalTreeSchema.parse(raw);
+    }
+    async deleteGoalTree(rootId) {
+        const filePath = path.join(this.baseDir, "goal-trees", `${rootId}.json`);
+        try {
+            await fsp.unlink(filePath);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    // ─── Observation Log ───
+    async saveObservationLog(log) {
+        const parsed = ObservationLogSchema.parse(log);
+        const dir = await this.goalDir(parsed.goal_id);
+        await this.atomicWrite(path.join(dir, "observations.json"), parsed);
+    }
+    async loadObservationLog(goalId) {
+        const filePath = path.join(this.baseDir, "goals", goalId, "observations.json");
+        const raw = await this.atomicRead(filePath);
+        if (raw === null)
+            return null;
+        return ObservationLogSchema.parse(raw);
+    }
+    async appendObservation(goalId, entry) {
+        const parsed = ObservationLogEntrySchema.parse(entry);
+        if (parsed.goal_id !== goalId) {
+            throw new StateError(`appendObservation: entry.goal_id ("${parsed.goal_id}") does not match goalId ("${goalId}")`);
+        }
+        let log = await this.loadObservationLog(goalId);
+        if (log === null) {
+            log = { goal_id: goalId, entries: [] };
+        }
+        log.entries.push(parsed);
+        await this.saveObservationLog(log);
+    }
+    // ─── Gap History ───
+    async saveGapHistory(goalId, history) {
+        const parsed = history.map((e) => GapHistoryEntrySchema.parse(e));
+        const dir = await this.goalDir(goalId);
+        await this.atomicWrite(path.join(dir, "gap-history.json"), parsed);
+    }
+    async loadGapHistory(goalId) {
+        const filePath = path.join(this.baseDir, "goals", goalId, "gap-history.json");
+        const raw = await this.atomicRead(filePath);
+        if (raw === null)
+            return [];
+        return raw.map((e) => GapHistoryEntrySchema.parse(e));
+    }
+    async appendGapHistoryEntry(goalId, entry) {
+        const parsed = GapHistoryEntrySchema.parse(entry);
+        const history = await this.loadGapHistory(goalId);
+        history.push(parsed);
+        await this.saveGapHistory(goalId, history);
+    }
+    /**
+     * Save a pace snapshot to a milestone goal (persists to disk).
+     */
+    async savePaceSnapshot(goalId, snapshot) {
+        const goal = await this.loadGoal(goalId);
+        if (!goal) {
+            throw new StateError(`savePaceSnapshot: goal "${goalId}" not found`);
+        }
+        const updated = { ...goal, pace_snapshot: snapshot };
+        await this.saveGoal(updated);
+    }
+    // ─── Goal Tree Traversal ───
+    /**
+     * BFS traversal starting at rootId.
+     * Returns null if rootId doesn't exist, otherwise returns goals in BFS order.
+     */
+    async bfsCollect(rootId) {
+        const root = await this.loadGoal(rootId);
+        if (root === null)
+            return null;
+        const result = [];
+        const queue = [rootId];
+        const visited = new Set();
+        while (queue.length > 0) {
+            const currentId = queue.shift();
+            if (visited.has(currentId))
+                continue;
+            visited.add(currentId);
+            const goal = await this.loadGoal(currentId);
+            if (goal === null)
+                continue;
+            result.push(goal);
+            for (const childId of goal.children_ids) {
+                if (!visited.has(childId)) {
+                    queue.push(childId);
+                }
+            }
+        }
+        return result;
+    }
+    /**
+     * Get the full goal tree rooted at rootId.
+     * Returns null if the root goal doesn't exist.
+     * Returns goals in BFS order: root first, then children level by level.
+     */
+    async getGoalTree(rootId) {
+        return this.bfsCollect(rootId);
+    }
+    /**
+     * Get all goals in the subtree of goalId (including goalId itself).
+     * Returns [] if goal not found.
+     */
+    async getSubtree(goalId) {
+        return (await this.bfsCollect(goalId)) ?? [];
+    }
+    /**
+     * Update a goal that belongs to a tree, handling both goal and tree consistency.
+     * Merges updates into the existing goal, preserving its id.
+     * If the goal has a parent_id, ensures the parent's children_ids still includes this goal.
+     */
+    async updateGoalInTree(goalId, updates) {
+        const existingGoal = await this.loadGoal(goalId);
+        if (existingGoal === null) {
+            throw new StateError(`updateGoalInTree: goal "${goalId}" not found`);
+        }
+        const updatedGoal = {
+            ...existingGoal,
+            ...updates,
+            id: existingGoal.id, // id is immutable
+        };
+        await this.saveGoal(updatedGoal);
+        // Ensure parent's children_ids still includes this goal
+        if (existingGoal.parent_id !== null) {
+            const parent = await this.loadGoal(existingGoal.parent_id);
+            if (parent !== null && !parent.children_ids.includes(goalId)) {
+                await this.saveGoal({
+                    ...parent,
+                    children_ids: [...parent.children_ids, goalId],
+                    updated_at: new Date().toISOString(),
+                });
+            }
+        }
+    }
+    // ─── Utility ───
+    /** Check whether a goal directory exists */
+    async goalExists(goalId) {
+        try {
+            await fsp.access(path.join(this.baseDir, "goals", goalId, "goal.json"));
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * Restore dimension values and trust balance from a loop crash-recovery checkpoint.
+     * Uses Zod validation on both the checkpoint and the goal.
+     * Returns the saved cycle_number so the caller can resume iteration counting,
+     * or 0 if no checkpoint exists or restoration fails (non-fatal).
+     */
+    async restoreFromCheckpoint(goalId, adapterType, trustManager) {
+        try {
+            const raw = await this.atomicRead(path.join(this.baseDir, "goals", goalId, "checkpoint.json"));
+            if (raw === null)
+                return 0;
+            const parseResult = LoopCheckpointSchema.safeParse(raw);
+            if (!parseResult.success) {
+                this.logger?.warn(`[StateManager] Invalid checkpoint for "${goalId}": ${parseResult.error.message}`);
+                return 0;
+            }
+            const cp = parseResult.data;
+            // Restore dimension values from snapshot
+            if (cp.dimension_snapshot) {
+                const goal = await this.loadGoal(goalId);
+                if (goal !== null) {
+                    const updatedDimensions = goal.dimensions.map((dim) => {
+                        const snapshotVal = cp.dimension_snapshot[dim.name];
+                        return typeof snapshotVal === "number"
+                            ? { ...dim, current_value: snapshotVal }
+                            : dim;
+                    });
+                    await this.saveGoal({ ...goal, dimensions: updatedDimensions });
+                }
+            }
+            // Restore trust balance for the adapter domain
+            if (typeof cp.trust_snapshot === "number" && trustManager) {
+                try {
+                    await trustManager.setOverride(adapterType, cp.trust_snapshot, "checkpoint_restore");
+                }
+                catch {
+                    // Non-fatal — trust restore failure should not abort the run
+                }
+            }
+            return cp.cycle_number;
+        }
+        catch {
+            // Checkpoint restore failure is non-fatal — caller starts from beginning
+            return 0;
+        }
+    }
+    /** Read raw JSON from any path relative to base dir */
+    async readRaw(relativePath) {
+        const resolved = path.resolve(this.baseDir, relativePath);
+        if (!resolved.startsWith(path.resolve(this.baseDir) + path.sep)) {
+            throw new Error(`Path traversal detected: ${relativePath}`);
+        }
+        return this.atomicRead(resolved);
+    }
+    /** Write raw JSON to any path relative to base dir (atomic) */
+    async writeRaw(relativePath, data) {
+        const resolved = path.resolve(this.baseDir, relativePath);
+        if (!resolved.startsWith(path.resolve(this.baseDir) + path.sep)) {
+            throw new Error(`Path traversal detected: ${relativePath}`);
+        }
+        const filePath = resolved;
+        const dir = path.dirname(filePath);
+        try {
+            await fsp.mkdir(dir, { recursive: true });
+        }
+        catch (err) {
+            // Base dir removed (e.g. test cleanup) — silently skip write
+            if (err.code === "ENOENT")
+                return;
+            throw err;
+        }
+        await this.atomicWrite(filePath, data);
+    }
+}
+//# sourceMappingURL=state-manager.js.map

package/dist/state-manager.js.map

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

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

@@ -0,0 +1,115 @@
+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 [0,1] severity for a single goal dimension.
+     * Delegates to computeRawGap + normalizeGap from gap-calculator.
+     */
+    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