pulseed 0.1.5 → 0.2.0

package/dist/orchestrator/strategy/strategy-helpers.js

@@ -0,0 +1,178 @@
+import { z } from "zod";
+import { StrategySchema } from "../../base/types/strategy.js";
+import { KnowledgeGapSignalSchema } from "../../base/types/knowledge.js";
+// ─── Valid state transitions ───
+export const VALID_TRANSITIONS = {
+    candidate: ["active"],
+    active: ["completed", "terminated", "evaluating"],
+    evaluating: ["active", "terminated"],
+    suspended: ["active", "terminated"],
+    completed: [],
+    terminated: [],
+};
+// ─── Internal schema for parsing LLM array response ───
+export const StrategyArraySchema = z.array(z.object({
+    id: z.string().optional(),
+    hypothesis: z.string(),
+    expected_effect: z.array(z.object({
+        dimension: z.string(),
+        direction: z.enum(["increase", "decrease"]),
+        magnitude: z.enum(["small", "medium", "large"]),
+    })),
+    resource_estimate: z.object({
+        sessions: z.number(),
+        duration: z.object({
+            value: z.number(),
+            unit: z.enum(["minutes", "hours", "days", "weeks"]),
+        }),
+        llm_calls: z.number().nullable().default(null),
+    }),
+    allocation: z.number().min(0).max(1).default(0),
+    required_tools: z.array(z.string()).default([]),
+}));
+/**
+ * Unwrap a potentially-wrapped LLM response before schema validation.
+ * LLMs may return a wrapper object instead of a bare array. This function
+ * checks common wrapper keys, then falls back to single-key unwrapping.
+ */
+export function unwrapStrategyResponse(raw) {
+    if (raw === null || typeof raw !== "object" || Array.isArray(raw)) {
+        return raw;
+    }
+    const record = raw;
+    for (const key of ["candidates", "strategies", "data", "results", "items"]) {
+        if (Array.isArray(record[key]))
+            return record[key];
+    }
+    const keys = Object.keys(record);
+    if (keys.length === 1 && Array.isArray(record[keys[0]])) {
+        return record[keys[0]];
+    }
+    return raw;
+}
+// ─── LLM prompt builder ───
+export function buildGenerationPrompt(goalId, primaryDimension, targetDimensions, context, enrichment) {
+    // Sort all past strategies most recent first
+    const sorted = [...context.pastStrategies].sort((a, b) => new Date(b.created_at).getTime() - new Date(a.created_at).getTime());
+    // Partition into dimension-relevant and other strategies
+    const dimensionRelevant = sorted.filter((s) => s.primary_dimension === primaryDimension ||
+        s.target_dimensions.includes(primaryDimension));
+    const otherStrategies = sorted.filter((s) => s.primary_dimension !== primaryDimension &&
+        !s.target_dimensions.includes(primaryDimension));
+    // Fallback: if fewer than 3 dimension-relevant, pad with other same-goal strategies
+    const MIN_RELEVANT = 3;
+    const MAX_TOTAL = 10;
+    let selectedRelevant = dimensionRelevant.slice(0, MAX_TOTAL);
+    let selectedOther = [];
+    if (selectedRelevant.length < MIN_RELEVANT) {
+        const needed = Math.min(MIN_RELEVANT - selectedRelevant.length, otherStrategies.length);
+        selectedOther = otherStrategies.slice(0, needed);
+    }
+    // Cap total at 10
+    const totalRelevant = selectedRelevant.length;
+    const remainingCap = MAX_TOTAL - totalRelevant;
+    selectedOther = selectedOther.slice(0, remainingCap);
+    const formatStrategy = (s) => `- "${s.hypothesis}" (state: ${s.state}, effectiveness: ${s.effectiveness_score ?? "unknown"})`;
+    let pastSummary;
+    if (selectedRelevant.length === 0 && selectedOther.length === 0) {
+        pastSummary = "None";
+    }
+    else {
+        const parts = [];
+        if (selectedRelevant.length > 0) {
+            parts.push(`Relevant past strategies for this dimension:\n${selectedRelevant.map(formatStrategy).join("\n")}`);
+        }
+        if (selectedOther.length > 0) {
+            parts.push(`Other strategies from this goal:\n${selectedOther.map(formatStrategy).join("\n")}`);
+        }
+        pastSummary = parts.join("\n\n");
+    }
+    const enrichmentSection = [
+        enrichment?.workspaceBlock ?? "",
+        enrichment?.templatesBlock ?? "",
+        enrichment?.lessonsBlock ?? "",
+    ]
+        .filter(Boolean)
+        .join("\n\n");
+    return `Generate 1-2 strategic approaches to close the gap for goal "${goalId}".
+
+Primary dimension to improve: ${primaryDimension}
+All target dimensions: ${targetDimensions.join(", ")}
+Current gap score: ${context.currentGap} (0=closed, 1=fully open)
+
+Past strategies tried:
+${pastSummary}
+${enrichmentSection ? `\n${enrichmentSection}\n` : ""}
+Return a JSON array of strategies. Each strategy must follow this schema:
+{
+  "hypothesis": "string - the core bet/approach",
+  "expected_effect": [
+    { "dimension": "string", "direction": "increase"|"decrease", "magnitude": "small"|"medium"|"large" }
+  ],
+  "resource_estimate": {
+    "sessions": number,
+    "duration": { "value": number, "unit": "hours"|"days"|"weeks"|"minutes" },
+    "llm_calls": number|null
+  },
+  "allocation": number (0-1),
+  "required_tools": ["tool-name-1", "tool-name-2"]  // list tool names this strategy needs (empty array if none)
+}
+
+Do not repeat strategies that have already been tried. Respond with only the JSON array inside a markdown code block.`;
+}
+// ─── Allocation redistribution helper ───
+/**
+ * Redistribute freed allocation proportionally among remaining strategies.
+ * Returns a new array with updated allocations. Pure function.
+ */
+export function redistributeAllocation(strategies, excludeId, freedAllocation) {
+    const remaining = strategies.filter((s) => s.id !== excludeId && (s.state === "active" || s.state === "evaluating"));
+    if (remaining.length === 0 || freedAllocation <= 0) {
+        return strategies;
+    }
+    const totalRemainingAlloc = remaining.reduce((sum, s) => sum + s.allocation, 0);
+    return strategies.map((s) => {
+        if (!remaining.some((r) => r.id === s.id))
+            return s;
+        const share = totalRemainingAlloc > 0
+            ? s.allocation / totalRemainingAlloc
+            : 1.0 / remaining.length;
+        return StrategySchema.parse({
+            ...s,
+            allocation: s.allocation + freedAllocation * share,
+        });
+    });
+}
+// ─── Knowledge gap detection (pure function) ───
+/**
+ * Detect whether a set of strategy candidates indicates a knowledge gap.
+ *
+ * Rules:
+ *   - Zero candidates → `strategy_deadlock` (no hypotheses can be formed)
+ *   - All candidates have effectiveness_score < 0.3 AND not null →
+ *     `strategy_deadlock` (all known approaches exhausted)
+ *
+ * Returns null when candidates look viable.
+ */
+export function detectStrategyGap(candidates) {
+    if (candidates.length === 0) {
+        return KnowledgeGapSignalSchema.parse({
+            signal_type: "strategy_deadlock",
+            missing_knowledge: "No strategies available — domain knowledge needed to generate hypotheses",
+            source_step: "strategy_selection",
+            related_dimension: null,
+        });
+    }
+    const scoredCandidates = candidates.filter((c) => c.effectiveness_score !== null);
+    if (scoredCandidates.length > 0 &&
+        scoredCandidates.every((c) => (c.effectiveness_score ?? 1) < 0.3)) {
+        return KnowledgeGapSignalSchema.parse({
+            signal_type: "strategy_deadlock",
+            missing_knowledge: "All known strategies have low effectiveness — domain knowledge needed to form new hypotheses",
+            source_step: "strategy_selection",
+            related_dimension: null,
+        });
+    }
+    return null;
+}
+//# sourceMappingURL=strategy-helpers.js.map

package/dist/orchestrator/strategy/strategy-helpers.js.map

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

package/dist/orchestrator/strategy/strategy-manager-base.d.ts

@@ -0,0 +1,120 @@
+import { StateManager } from "../../base/state/state-manager.js";
+import type { Strategy, Portfolio } from "../../base/types/strategy.js";
+import type { StrategyState } from "../../base/types/core.js";
+import type { ILLMClient } from "../../base/llm/llm-client.js";
+import type { IPromptGateway } from "../../prompt/gateway.js";
+import type { KnowledgeGapSignal } from "../../base/types/knowledge.js";
+import type { KnowledgeManager } from "../../platform/knowledge/knowledge-manager.js";
+import type { StrategyTemplateRegistry } from "./strategy-template-registry.js";
+import type { Logger } from "../../runtime/logger.js";
+import type { ToolExecutor } from "../../tools/executor.js";
+import type { ToolCallContext } from "../../tools/types.js";
+import type { ToolRegistry } from "../../tools/registry.js";
+import { WorkspaceContextCache } from "./strategy-workspace.js";
+/**
+ * Base class for StrategyManager.
+ * Contains constructor, core lifecycle methods, and private persistence helpers.
+ * Phase 2 portfolio methods live in the StrategyManager subclass.
+ */
+export declare class StrategyManagerBase {
+    protected readonly stateManager: StateManager;
+    protected readonly llmClient: ILLMClient;
+    /** Optional KnowledgeManager for decision-history-aware strategy selection (M14-S3). */
+    protected knowledgeManager?: KnowledgeManager;
+    /** Optional PromptGateway for memory-enriched LLM calls. */
+    protected promptGateway?: IPromptGateway;
+    /** Optional StrategyTemplateRegistry for auto-templating successful strategies. */
+    private strategyTemplateRegistry?;
+    /** Optional Logger for diagnostic output. */
+    protected logger?: Logger;
+    /** In-memory index: strategyId → goalId */
+    protected readonly strategyIndex: Map<string, string>;
+    /** Optional ToolExecutor for workspace context gathering (Phase 4-B). */
+    protected toolExecutor?: ToolExecutor;
+    /** Optional ToolRegistry for scoring candidates by tool availability (Issue #476). */
+    protected toolRegistry?: ToolRegistry;
+    /** Per-iteration workspace context cache (Phase 4-B). */
+    protected readonly workspaceCache: WorkspaceContextCache;
+    constructor(stateManager: StateManager, llmClient: ILLMClient, knowledgeManager?: KnowledgeManager, promptGateway?: IPromptGateway, logger?: Logger);
+    /** Inject or update KnowledgeManager after construction (e.g., when KM is instantiated after SM). */
+    setKnowledgeManager(km: KnowledgeManager): void;
+    /** Inject StrategyTemplateRegistry for auto-templating successful strategies. */
+    setStrategyTemplateRegistry(registry: StrategyTemplateRegistry): void;
+    /** Inject ToolExecutor for workspace context gathering (Phase 4-B). */
+    setToolExecutor(executor: ToolExecutor): void;
+    /** Inject ToolRegistry for tool-availability scoring in activateBestCandidate (Issue #476). */
+    setToolRegistry(registry: ToolRegistry): void;
+    /**
+     * Generate 1–2 strategy candidates via LLM.
+     * Validates each with StrategySchema, sets state="candidate", stores in portfolio.
+     *
+     * Optional `enrichment` injects strategy templates and lessons into the prompt.
+     */
+    generateCandidates(goalId: string, primaryDimension: string, targetDimensions: string[], context: {
+        currentGap: number;
+        pastStrategies: Strategy[];
+    }, enrichment?: {
+        templatesBlock?: string;
+        lessonsBlock?: string;
+    }, toolContext?: {
+        toolCallContext: ToolCallContext;
+        iteration: number;
+    }): Promise<Strategy[]>;
+    /**
+     * Activate the first candidate strategy for a goal.
+     * Sets state="active" and started_at=now.
+     */
+    activateBestCandidate(goalId: string): Promise<Strategy>;
+    /**
+     * Transition a strategy to a new state.
+     * Throws if the transition is not valid or strategy is not found.
+     */
+    updateState(strategyId: string, newState: StrategyState, metadata?: {
+        effectiveness_score?: number;
+    }): Promise<void>;
+    /**
+     * React to a stall detection event.
+     * - stallCount === 1: return null (no strategy change; notify only)
+     * - stallCount >= 2: terminate current strategy, generate new candidates, activate best
+     * - If no candidates can be generated: return null
+     *
+     * When knowledgeManager is available and goalType is given, past decision history
+     * is used to deprioritize previously-pivoted strategies (M14-S3).
+     */
+    onStallDetected(goalId: string, stallCount: number, goalType?: string): Promise<Strategy | null>;
+    /**
+     * M14-S3: Rank candidates using past decision history.
+     * Strategies that were previously PIVOTed are deprioritized (moved to end).
+     * Strategies that succeeded are prioritized (moved to front).
+     * Falls back to original order when < 3 records exist.
+     */
+    protected _rankCandidatesByDecisionHistory(candidates: Strategy[], goalType: string): Promise<Strategy[]>;
+    /**
+     * Increment the pivot_count on a strategy and persist the portfolio.
+     * No-op if the strategy is not found.
+     */
+    incrementPivotCount(goalId: string, strategyId: string): Promise<void>;
+    /**
+     * Returns the currently active strategy for a goal, or null.
+     */
+    getActiveStrategy(goalId: string): Promise<Strategy | null>;
+    /**
+     * Returns the full portfolio for a goal, or null if none has been persisted.
+     */
+    getPortfolio(goalId: string): Promise<Portfolio | null>;
+    /**
+     * Returns all strategies in history (terminated/completed) for a goal.
+     */
+    getStrategyHistory(goalId: string): Promise<Strategy[]>;
+    /** Delegates to the pure helper in strategy-helpers.ts. */
+    detectStrategyGap(candidates: Strategy[]): KnowledgeGapSignal | null;
+    protected loadOrCreatePortfolio(goalId: string): Promise<Portfolio>;
+    savePortfolio(goalId: string, portfolio: Portfolio): Promise<void>;
+    protected appendToHistory(goalId: string, strategy: Strategy): Promise<void>;
+    /**
+     * Resolve a goalId from a strategyId using the in-memory index.
+     * Falls back to scanning goal directories if not in index.
+     */
+    protected resolveGoalId(strategyId: string): Promise<string | null>;
+}
+//# sourceMappingURL=strategy-manager-base.d.ts.map

package/dist/orchestrator/strategy/strategy-manager-base.d.ts.map

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