pi-para 0.5.5 → 0.6.1

package/dist/gepa/targets.js.map

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

package/dist/gepa/types.d.ts

@@ -1,168 +0,0 @@
-/**
- * GEPA (Genetic-Evolutionary Prompt Adaptation) — shared types.
- *
- * All types used across the GEPA optimizer pipeline:
- * config, targets, candidates, evaluation, Pareto frontier, and deployment.
- */
-/** GEPA optimizer configuration (stored in config.json under "gepa" key). */
-export interface GEPAConfig {
-    /** Model for reflection/mutation. Format: "provider/model-id".
-     *  Resolution: this → daemonModel → AuthStorage auto-detect → qmd config. */
-    reflectionModel: string | null;
-    /** Maximum optimization iterations per target. */
-    maxIterations: number;
-    /** Maximum number of candidates retained on the Pareto frontier. */
-    paretoSize: number;
-    /** When true, optimized prompts are loaded at runtime instead of originals. */
-    useOptimized: boolean;
-}
-/** Default GEPA config values. */
-export declare const DEFAULT_GEPA_CONFIG: GEPAConfig;
-/** The kind of content being optimized. */
-export type TargetType = "prompt" | "skill";
-/** An optimization target — a prompt template or skill document to improve. */
-export interface Target {
-    /** Unique identifier (e.g. "wiki-system-prompt", "para-skill"). */
-    name: string;
-    /** Whether this is a prompt template or a skill document. */
-    type: TargetType;
-    /** Retrieve the current (original) content of this target. */
-    getCurrentContent: () => Promise<string>;
-    /** Constraints the optimizer must respect (e.g. "must include PARA categories"). */
-    constraints: string[];
-    /** Optional description of what this target does (used in reflection). */
-    description?: string;
-    /** File path where the original content lives (for reference/logging). */
-    sourcePath?: string;
-}
-/** A unique identifier for a candidate in the optimization run. */
-export type CandidateId = string;
-/** A mutated version of a target's content, with evaluation scores. */
-export interface Candidate {
-    /** Unique identifier for this candidate. */
-    id: CandidateId;
-    /** The mutated prompt/skill content. */
-    content: string;
-    /** Composite score (0-1), computed from dimension scores. */
-    score: number;
-    /** Per-dimension evaluation results. */
-    dimensions: EvalDimension[];
-    /** Which iteration produced this candidate. */
-    iteration: number;
-    /** ID of the parent candidate this was mutated from (null for the original). */
-    parentId: CandidateId | null;
-    /** The mutation description applied to produce this candidate. */
-    mutationDescription?: string;
-}
-/** A single scored dimension from the LLM judge. */
-export interface EvalDimension {
-    /** Dimension name (e.g. "clarity", "actionability"). */
-    name: string;
-    /** Score from 0 (worst) to 1 (best). */
-    score: number;
-    /** Brief textual feedback from the judge for this dimension. */
-    feedback: string;
-    /** Weight of this dimension in the composite score (0-1, should sum to 1). */
-    weight: number;
-}
-/** Full evaluation result returned by the LLM judge. */
-export interface EvalResult {
-    /** Composite score (0-1), weighted average of dimension scores. */
-    score: number;
-    /** Per-dimension scores and feedback. */
-    dimensions: EvalDimension[];
-    /** Overall textual feedback from the judge. */
-    overallFeedback: string;
-}
-/** Standard evaluation dimensions used across all targets. */
-export declare const STANDARD_DIMENSIONS: ReadonlyArray<{
-    name: string;
-    weight: number;
-}>;
-/**
- * Pareto frontier — maintains the best non-dominated candidates.
- *
- * A candidate dominates another if it scores >= on ALL dimensions
- * and strictly > on at least one. The frontier keeps only non-dominated
- * candidates, capped at `maxSize`.
- */
-export declare class ParetoFrontier {
-    private _candidates;
-    private readonly maxSize;
-    constructor(maxSize?: number);
-    /** Current candidates on the frontier. */
-    get candidates(): ReadonlyArray<Candidate>;
-    /** Number of candidates on the frontier. */
-    get size(): number;
-    /**
-     * Attempt to add a candidate to the frontier.
-     * Returns true if the candidate was added (i.e., it is non-dominated).
-     */
-    add(candidate: Candidate): boolean;
-    /**
-     * Get the best candidate by composite score.
-     * Returns undefined if the frontier is empty.
-     */
-    best(): Candidate | undefined;
-    /**
-     * Get the top N candidates by composite score.
-     */
-    topN(n: number): Candidate[];
-    /** Serialize the frontier for persistence. */
-    toJSON(): CandidateJSON[];
-    /** Restore the frontier from persisted data. */
-    static fromJSON(data: CandidateJSON[], maxSize: number): ParetoFrontier;
-}
-/** JSON-serializable candidate shape (same as Candidate). */
-type CandidateJSON = Omit<Candidate, never>;
-/** A saved optimized prompt, ready for deployment. */
-export interface OptimizedPrompt {
-    /** Target name this optimized prompt belongs to. */
-    targetName: string;
-    /** The optimized content. */
-    content: string;
-    /** Composite score achieved. */
-    score: number;
-    /** ISO timestamp when optimization completed. */
-    optimizedAt: string;
-    /** Number of iterations run. */
-    iterationsRun: number;
-    /** Model used for optimization (e.g. "anthropic/claude-opus-4-6"). */
-    modelUsed: string;
-    /** Original score before optimization (for comparison). */
-    originalScore?: number;
-    /** The dimensions breakdown. */
-    dimensions?: EvalDimension[];
-}
-/** Summary of a complete optimization run. */
-export interface OptimizationRunSummary {
-    /** Target that was optimized. */
-    targetName: string;
-    /** Total iterations executed. */
-    iterations: number;
-    /** Original (baseline) score. */
-    originalScore: number;
-    /** Best score achieved. */
-    bestScore: number;
-    /** Score improvement (best - original). */
-    improvement: number;
-    /** Model used. */
-    model: string;
-    /** ISO timestamp when the run started. */
-    startedAt: string;
-    /** ISO timestamp when the run completed. */
-    completedAt: string;
-    /** Duration in seconds. */
-    durationSeconds: number;
-    /** Number of candidates that made it to the Pareto frontier. */
-    frontierSize: number;
-}
-/** Minimal LLM completion client interface used by the optimizer. */
-export interface LLMClient {
-    /** Send a prompt to the LLM and get a text response. */
-    complete(prompt: string, system?: string): Promise<string>;
-    /** The model identifier being used (e.g. "anthropic/claude-opus-4-6"). */
-    modelId: string;
-}
-export {};
-//# sourceMappingURL=types.d.ts.map

package/dist/gepa/types.d.ts.map

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

package/dist/gepa/types.js

@@ -1,124 +0,0 @@
-/**
- * GEPA (Genetic-Evolutionary Prompt Adaptation) — shared types.
- *
- * All types used across the GEPA optimizer pipeline:
- * config, targets, candidates, evaluation, Pareto frontier, and deployment.
- */
-/** Default GEPA config values. */
-export const DEFAULT_GEPA_CONFIG = {
-    reflectionModel: null,
-    maxIterations: 50,
-    paretoSize: 10,
-    useOptimized: false,
-};
-/** Standard evaluation dimensions used across all targets. */
-export const STANDARD_DIMENSIONS = [
-    { name: "structure", weight: 0.15 },
-    { name: "clarity", weight: 0.25 },
-    { name: "actionability", weight: 0.25 },
-    { name: "completeness", weight: 0.20 },
-    { name: "error-prevention", weight: 0.15 },
-];
-// -- Pareto Frontier ---------------------------------------------------------
-/**
- * Pareto frontier — maintains the best non-dominated candidates.
- *
- * A candidate dominates another if it scores >= on ALL dimensions
- * and strictly > on at least one. The frontier keeps only non-dominated
- * candidates, capped at `maxSize`.
- */
-export class ParetoFrontier {
-    _candidates = [];
-    maxSize;
-    constructor(maxSize = 10) {
-        this.maxSize = maxSize;
-    }
-    /** Current candidates on the frontier. */
-    get candidates() {
-        return this._candidates;
-    }
-    /** Number of candidates on the frontier. */
-    get size() {
-        return this._candidates.length;
-    }
-    /**
-     * Attempt to add a candidate to the frontier.
-     * Returns true if the candidate was added (i.e., it is non-dominated).
-     */
-    add(candidate) {
-        // Check if the new candidate is dominated by any existing candidate
-        for (const existing of this._candidates) {
-            if (dominates(existing, candidate)) {
-                return false; // dominated — don't add
-            }
-        }
-        // Remove any existing candidates that are dominated by the new one
-        this._candidates = this._candidates.filter((existing) => !dominates(candidate, existing));
-        // Add the new candidate
-        this._candidates.push(candidate);
-        // If over capacity, remove the lowest-scoring candidate
-        if (this._candidates.length > this.maxSize) {
-            this._candidates.sort((a, b) => b.score - a.score);
-            this._candidates = this._candidates.slice(0, this.maxSize);
-        }
-        return true;
-    }
-    /**
-     * Get the best candidate by composite score.
-     * Returns undefined if the frontier is empty.
-     */
-    best() {
-        if (this._candidates.length === 0)
-            return undefined;
-        return this._candidates.reduce((best, c) => (c.score > best.score ? c : best));
-    }
-    /**
-     * Get the top N candidates by composite score.
-     */
-    topN(n) {
-        return [...this._candidates]
-            .sort((a, b) => b.score - a.score)
-            .slice(0, n);
-    }
-    /** Serialize the frontier for persistence. */
-    toJSON() {
-        return this._candidates.map((c) => ({
-            id: c.id,
-            content: c.content,
-            score: c.score,
-            dimensions: c.dimensions,
-            iteration: c.iteration,
-            parentId: c.parentId,
-            mutationDescription: c.mutationDescription,
-        }));
-    }
-    /** Restore the frontier from persisted data. */
-    static fromJSON(data, maxSize) {
-        const frontier = new ParetoFrontier(maxSize);
-        for (const c of data) {
-            frontier._candidates.push(c);
-        }
-        return frontier;
-    }
-}
-/**
- * Check if candidate `a` dominates candidate `b`.
- * `a` dominates `b` if a.score >= b.score on ALL dimensions
- * and strictly > on at least one.
- */
-function dominates(a, b) {
-    if (a.dimensions.length !== b.dimensions.length)
-        return false;
-    let strictlyBetterOnAtLeastOne = false;
-    for (let i = 0; i < a.dimensions.length; i++) {
-        const aDim = a.dimensions.find((d) => d.name === b.dimensions[i].name);
-        if (!aDim)
-            return false; // different dimension sets — can't compare
-        if (aDim.score < b.dimensions[i].score)
-            return false; // a is worse on this dim
-        if (aDim.score > b.dimensions[i].score)
-            strictlyBetterOnAtLeastOne = true;
-    }
-    return strictlyBetterOnAtLeastOne;
-}
-//# sourceMappingURL=types.js.map

package/dist/gepa/types.js.map

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

package/scripts/gepa/dataset.py

@@ -1,192 +0,0 @@
-"""Build trainset/valset from real wiki pages.
-
-Each example pairs a synthetic task context (derived from the page topic)
-with the actual page body as expected output. The proxy module runs the
-instruction on the task context; the metric scores how well the output
-matches the gold page.
-"""
-
-from __future__ import annotations
-
-import random
-from typing import Any
-
-import dspy
-
-from wiki_reader import WikiPage, load_all_pages, get_wiki_stats
-
-
-# -- Task context generators --------------------------------------------------
-
-def _capture_context(page: WikiPage) -> str:
-    """Generate a synthetic capture-style task context from a wiki page."""
-    scope_str = ", ".join(page.scope) if page.scope else "unknown"
-    tags_str = ", ".join(page.tags[:5]) if page.tags else ""
-    # Simulate what a session about this topic would look like
-    return (
-        f"A coding session about '{page.title}' in the {scope_str} project. "
-        f"Topics covered: {tags_str}. "
-        f"Extract and organize the key knowledge from this session into a wiki page."
-    )
-
-
-def _ingest_context(page: WikiPage) -> str:
-    """Generate a synthetic ingest-style task context."""
-    return (
-        f"Ingest the following source material about '{page.title}' "
-        f"into the PARA wiki. Organize into a structured page with "
-        f"proper frontmatter, sections, and cross-references."
-    )
-
-
-def _query_context(page: WikiPage) -> str:
-    """Generate a synthetic query-style task context."""
-    return (
-        f"The user asked about '{page.title}'. "
-        f"Search results returned pages related to: {', '.join(page.scope)}. "
-        f"Synthesize a helpful answer citing specific wiki pages."
-    )
-
-
-def _maintenance_context(page: WikiPage) -> str:
-    """Generate a synthetic maintenance-style task context."""
-    link_count = len(page.links)
-    return (
-        f"Review the wiki page '{page.title}' ({page.category}/{page.slug}). "
-        f"It has {link_count} outgoing links, scope [{', '.join(page.scope)}], "
-        f"tags [{', '.join(page.tags[:5])}]. "
-        f"Check for correct categorization, missing links, and content quality."
-    )
-
-
-def _tool_context(page: WikiPage) -> str:
-    """Generate a task context for tool instruction optimization."""
-    return (
-        f"A user wants to work with the wiki page '{page.title}' "
-        f"in category '{page.category}', scope [{', '.join(page.scope)}]. "
-        f"Guide them on how to use wiki tools effectively."
-    )
-
-
-def _skill_context(page: WikiPage) -> str:
-    """Generate a task context for skill optimization."""
-    return (
-        f"Working on a task related to '{page.title}' in the {', '.join(page.scope)} project. "
-        f"Apply the PARA knowledge management methodology to this work."
-    )
-
-
-# Target type → context generator
-CONTEXT_GENERATORS = {
-    "capture": _capture_context,
-    "ingest": _ingest_context,
-    "query": _query_context,
-    "maintenance": _maintenance_context,
-    "tool": _tool_context,
-    "skill": _skill_context,
-    "system": _capture_context,  # system prompts use capture-style context
-}
-
-
-# -- Dataset builder -----------------------------------------------------------
-
-def build_dataset(
-    wiki_dir: str,
-    target_type: str = "capture",
-    max_examples: int = 50,
-    val_ratio: float = 0.4,
-    seed: int = 42,
-) -> tuple[list[dspy.Example], list[dspy.Example]]:
-    """Build train/val datasets from real wiki pages.
-
-    Args:
-        wiki_dir: Path to wiki directory (e.g. ~/.pi/wiki)
-        target_type: Type of target being optimized (capture, ingest, query, etc.)
-        max_examples: Maximum total examples
-        val_ratio: Fraction of examples for validation
-        seed: Random seed for reproducible splits
-
-    Returns:
-        (trainset, valset) — lists of dspy.Example
-    """
-    pages = load_all_pages(wiki_dir)
-
-    if not pages:
-        raise ValueError(f"No wiki pages found in {wiki_dir}")
-
-    # Filter to pages with substantial content (at least 200 chars body)
-    good_pages = [p for p in pages if len(p.body) >= 200]
-
-    if len(good_pages) < 4:
-        raise ValueError(f"Need at least 4 pages with content, found {len(good_pages)}")
-
-    # Shuffle deterministically
-    rng = random.Random(seed)
-    rng.shuffle(good_pages)
-
-    # Limit to max_examples
-    good_pages = good_pages[:max_examples]
-
-    # Get context generator for this target type
-    gen_context = CONTEXT_GENERATORS.get(target_type, _capture_context)
-
-    # Build examples
-    examples = []
-    for page in good_pages:
-        task_context = gen_context(page)
-
-        # Gold output: the actual page body (truncated to keep examples manageable)
-        expected_output = page.body[:3000] if len(page.body) > 3000 else page.body
-
-        example = dspy.Example(
-            task_context=task_context,
-            expected_output=expected_output,
-            # Metadata for the metric
-            expected_category=page.category,
-            expected_scope=",".join(page.scope),
-            expected_slug=page.slug,
-            expected_title=page.title,
-            page_link_count=str(len(page.links)),
-        ).with_inputs("task_context")
-
-        examples.append(example)
-
-    # Split into train/val
-    split_idx = max(1, int(len(examples) * (1 - val_ratio)))
-    trainset = examples[:split_idx]
-    valset = examples[split_idx:]
-
-    # Ensure minimum sizes
-    if len(trainset) < 2:
-        trainset = examples[:max(2, len(examples) // 2)]
-        valset = examples[len(trainset):]
-    if len(valset) < 2:
-        valset = trainset[-2:]  # share a few from train if needed
-
-    return trainset, valset
-
-
-def get_wiki_context(wiki_dir: str) -> str:
-    """Build a wiki context string for the metric/evaluator."""
-    stats = get_wiki_stats(wiki_dir)
-    pages = load_all_pages(wiki_dir)
-
-    # Build a brief summary of existing pages for context
-    page_summaries = []
-    for p in pages[:30]:  # Top 30 pages
-        first_line = ""
-        for line in p.body.split("\n"):
-            line = line.strip()
-            if line and not line.startswith("#"):
-                first_line = line[:100]
-                break
-        page_summaries.append(f"  - [[{p.slug}]] ({p.category}): {p.title}")
-
-    context = f"""Wiki has {stats['total_pages']} pages across categories: {stats['categories']}.
-Scopes: {', '.join(stats['unique_scopes'][:10])}.
-Avg links/page: {stats['avg_links_per_page']}.
-
-Existing pages:
-{chr(10).join(page_summaries)}"""
-
-    return context