pi-para 0.5.2

package/dist/gepa/optimizer.d.ts

@@ -0,0 +1,29 @@
+/**
+ * GEPA core optimization loop.
+ *
+ * Implements the Genetic-Evolutionary Prompt Adaptation algorithm:
+ *   1. Score the original prompt (baseline)
+ *   2. For N iterations: reflect → mutate → evaluate → update Pareto frontier
+ *   3. Return the best candidate from the frontier
+ *
+ * Early stopping: score >= 0.95, or no improvement in 10 consecutive iterations.
+ */
+import type { GEPAConfig, Target, Candidate, LLMClient, EvalResult } from "./types.js";
+import { ParetoFrontier } from "./types.js";
+declare const EARLY_STOP_SCORE = 0.95;
+declare const STAGNATION_LIMIT = 10;
+declare const REFLECTION_SYSTEM_PROMPT: string;
+export interface OptimizationResult {
+    best: Candidate;
+    frontier: ParetoFrontier;
+    baselineScore: number;
+    baselineEval: EvalResult;
+    iterationsRun: number;
+    stopReason: "max-iterations" | "early-stop-score" | "stagnation";
+}
+declare function buildReflectionPrompt(parent: Candidate, target: Target, iteration: number, maxIterations: number): string;
+declare function validateConstraints(content: string, constraints: string[]): string[];
+declare function selectParent(frontier: ParetoFrontier): Candidate;
+export declare function optimize(target: Target, config: GEPAConfig, llm: LLMClient, context: string): Promise<OptimizationResult>;
+export { buildReflectionPrompt, validateConstraints, selectParent, REFLECTION_SYSTEM_PROMPT, EARLY_STOP_SCORE, STAGNATION_LIMIT, };
+//# sourceMappingURL=optimizer.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"optimizer.d.ts","sourceRoot":"","sources":["../../src/gepa/optimizer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH,OAAO,KAAK,EACV,UAAU,EACV,MAAM,EACN,SAAS,EACT,SAAS,EACT,UAAU,EACX,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,cAAc,EAAuB,MAAM,YAAY,CAAC;AAKjE,QAAA,MAAM,gBAAgB,OAAO,CAAC;AAC9B,QAAA,MAAM,gBAAgB,KAAK,CAAC;AAG5B,QAAA,MAAM,wBAAwB,QAE2B,CAAC;AAI1D,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,SAAS,CAAC;IAChB,QAAQ,EAAE,cAAc,CAAC;IACzB,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,UAAU,CAAC;IACzB,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,gBAAgB,GAAG,kBAAkB,GAAG,YAAY,CAAC;CAClE;AAID,iBAAS,qBAAqB,CAC5B,MAAM,EAAE,SAAS,EACjB,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,EACjB,aAAa,EAAE,MAAM,GACpB,MAAM,CA+CR;AAID,iBAAS,mBAAmB,CAAC,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,CAe7E;AAmBD,iBAAS,YAAY,CAAC,QAAQ,EAAE,cAAc,GAAG,SAAS,CAWzD;AAID,wBAAsB,QAAQ,CAC5B,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,UAAU,EAClB,GAAG,EAAE,SAAS,EACd,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,kBAAkB,CAAC,CA6I7B;AAiFD,OAAO,EACL,qBAAqB,EACrB,mBAAmB,EACnB,YAAY,EACZ,wBAAwB,EACxB,gBAAgB,EAChB,gBAAgB,GACjB,CAAC"}

package/dist/gepa/optimizer.js

@@ -0,0 +1,249 @@
+/**
+ * GEPA core optimization loop.
+ *
+ * Implements the Genetic-Evolutionary Prompt Adaptation algorithm:
+ *   1. Score the original prompt (baseline)
+ *   2. For N iterations: reflect → mutate → evaluate → update Pareto frontier
+ *   3. Return the best candidate from the frontier
+ *
+ * Early stopping: score >= 0.95, or no improvement in 10 consecutive iterations.
+ */
+import { randomUUID } from "node:crypto";
+import { ParetoFrontier, DEFAULT_GEPA_CONFIG } from "./types.js";
+import { evaluateCandidate } from "./evaluator.js";
+// -- Constants ---------------------------------------------------------------
+const EARLY_STOP_SCORE = 0.95;
+const STAGNATION_LIMIT = 10;
+const MAX_MUTATION_RETRIES = 2;
+const REFLECTION_SYSTEM_PROMPT = "You are a prompt optimization expert. You improve prompts by analyzing " +
+    "evaluation feedback and making targeted improvements.";
+// -- Reflection prompt builder -----------------------------------------------
+function buildReflectionPrompt(parent, target, iteration, maxIterations) {
+    const sortedDims = [...parent.dimensions].sort((a, b) => a.score - b.score);
+    const dimFeedback = sortedDims
+        .map((d) => `  - ${d.name}: ${d.score.toFixed(2)}/1.00 — ${d.feedback}`)
+        .join("\n");
+    const constraintSection = target.constraints.length > 0
+        ? `\n## Required Constraints (MUST be preserved)\n\n${target.constraints.map((c, i) => `${i + 1}. ${c}`).join("\n")}\n`
+        : "";
+    const descSection = target.description
+        ? `\n**Purpose**: ${target.description}\n`
+        : "";
+    const weakest = sortedDims.slice(0, 2);
+    const weakestNames = weakest.map((d) => d.name).join(" and ");
+    return `# Prompt Optimization — Iteration ${iteration}/${maxIterations}
+
+## Target: "${target.name}" (${target.type})${descSection}
+
+## Current Prompt (score: ${parent.score.toFixed(3)})
+
+<current_prompt>
+${parent.content}
+</current_prompt>
+
+## Evaluation Feedback (per dimension, weakest first)
+
+${dimFeedback}
+
+## Weakest Dimensions
+
+Focus your improvements primarily on **${weakestNames}**, which scored lowest.
+${constraintSection}
+## Instructions
+
+Produce an improved version of this prompt. Rules:
+1. Keep ALL required concepts and constraints — do not remove anything essential.
+2. Focus on improving the weakest dimensions listed above.
+3. Make targeted, specific improvements — do not rewrite from scratch unnecessarily.
+4. Every sentence must earn its place — remove filler, improve precision.
+5. Maintain the same overall structure unless the structure itself is the problem.
+
+Output ONLY the improved prompt text, nothing else. No explanations, no commentary, no markdown code fences wrapping the prompt.`;
+}
+// -- Constraint validation ---------------------------------------------------
+function validateConstraints(content, constraints) {
+    if (constraints.length === 0)
+        return [];
+    const lower = content.toLowerCase();
+    const violations = [];
+    for (const constraint of constraints) {
+        const terms = extractKeyTerms(constraint);
+        const hasTerm = terms.some((t) => lower.includes(t.toLowerCase()));
+        if (!hasTerm) {
+            violations.push(constraint);
+        }
+    }
+    return violations;
+}
+function extractKeyTerms(constraint) {
+    const filler = new Set([
+        "must", "should", "include", "have", "contain", "mention",
+        "use", "provide", "specify", "ensure", "be", "the", "a", "an",
+        "and", "or", "for", "with", "about", "that", "this", "is", "are",
+        "in", "of", "to", "not", "no", "any", "all", "each",
+    ]);
+    return constraint
+        .toLowerCase()
+        .replace(/[^a-z0-9\s-]/g, "")
+        .split(/\s+/)
+        .filter((w) => w.length > 2 && !filler.has(w));
+}
+// -- Parent selection --------------------------------------------------------
+function selectParent(frontier) {
+    const best = frontier.best();
+    if (!best)
+        throw new Error("[gepa] Cannot select parent from empty frontier");
+    if (frontier.size <= 1 || Math.random() < 0.7) {
+        return best;
+    }
+    const candidates = frontier.candidates;
+    const idx = Math.floor(Math.random() * candidates.length);
+    return candidates[idx];
+}
+// -- Core optimization loop --------------------------------------------------
+export async function optimize(target, config, llm, context) {
+    const maxIterations = config.maxIterations ?? DEFAULT_GEPA_CONFIG.maxIterations;
+    const paretoSize = config.paretoSize ?? DEFAULT_GEPA_CONFIG.paretoSize;
+    const frontier = new ParetoFrontier(paretoSize);
+    // Step 1: Baseline evaluation
+    console.log(`[gepa] Evaluating baseline for "${target.name}"...`);
+    const originalContent = await target.getCurrentContent();
+    const baselineEval = await evaluateCandidate(originalContent, target, context, llm);
+    const baselineCandidate = {
+        id: randomUUID(),
+        content: originalContent,
+        score: baselineEval.score,
+        dimensions: baselineEval.dimensions,
+        iteration: 0,
+        parentId: null,
+        mutationDescription: "original",
+    };
+    frontier.add(baselineCandidate);
+    console.log(`[gepa] Baseline score: ${baselineEval.score.toFixed(3)} ` +
+        `[${baselineEval.dimensions.map((d) => `${d.name}:${d.score.toFixed(2)}`).join(", ")}]`);
+    if (baselineEval.score >= EARLY_STOP_SCORE) {
+        console.log(`[gepa] Baseline score >= ${EARLY_STOP_SCORE}, no optimization needed`);
+        return {
+            best: baselineCandidate,
+            frontier,
+            baselineScore: baselineEval.score,
+            baselineEval,
+            iterationsRun: 0,
+            stopReason: "early-stop-score",
+        };
+    }
+    // Step 2: Optimization iterations
+    let iterationsWithoutImprovement = 0;
+    let bestScoreSeen = baselineEval.score;
+    let stopReason = "max-iterations";
+    for (let i = 1; i <= maxIterations; i++) {
+        const parent = selectParent(frontier);
+        const mutatedContent = await generateMutation(parent, target, llm, i, maxIterations);
+        if (!mutatedContent) {
+            console.log(`[gepa] iter ${i}/${maxIterations}: mutation failed, skipping`);
+            iterationsWithoutImprovement++;
+            if (iterationsWithoutImprovement >= STAGNATION_LIMIT) {
+                console.log(`[gepa] Stagnation: no improvement in ${STAGNATION_LIMIT} iterations, stopping`);
+                stopReason = "stagnation";
+                break;
+            }
+            continue;
+        }
+        const evalResult = await evaluateCandidate(mutatedContent, target, context, llm);
+        const candidate = {
+            id: randomUUID(),
+            content: mutatedContent,
+            score: evalResult.score,
+            dimensions: evalResult.dimensions,
+            iteration: i,
+            parentId: parent.id,
+            mutationDescription: `Mutation from "${parent.id.slice(0, 8)}" at iter ${i}`,
+        };
+        const added = frontier.add(candidate);
+        if (candidate.score > bestScoreSeen) {
+            bestScoreSeen = candidate.score;
+            iterationsWithoutImprovement = 0;
+        }
+        else {
+            iterationsWithoutImprovement++;
+        }
+        const currentBest = frontier.best();
+        const bestScore = currentBest?.score ?? baselineEval.score;
+        const addedMarker = added ? " +" : "";
+        console.log(`[gepa] iter ${i}/${maxIterations}: score ${candidate.score.toFixed(3)} ` +
+            `(best: ${bestScore.toFixed(3)})${addedMarker}`);
+        if (candidate.score >= EARLY_STOP_SCORE) {
+            console.log(`[gepa] Score ${candidate.score.toFixed(3)} >= ${EARLY_STOP_SCORE}, stopping early`);
+            stopReason = "early-stop-score";
+            break;
+        }
+        if (iterationsWithoutImprovement >= STAGNATION_LIMIT) {
+            console.log(`[gepa] Stagnation: no improvement in ${STAGNATION_LIMIT} iterations, stopping`);
+            stopReason = "stagnation";
+            break;
+        }
+    }
+    // Step 3: Return results
+    const best = frontier.best() ?? baselineCandidate;
+    const maxIterationSeen = Math.max(...frontier.candidates.map((c) => c.iteration), 0);
+    const improvement = best.score - baselineEval.score;
+    console.log(`[gepa] Optimization complete for "${target.name}": ` +
+        `${baselineEval.score.toFixed(3)} → ${best.score.toFixed(3)} ` +
+        `(+${improvement.toFixed(3)}) in ${maxIterationSeen} iterations ` +
+        `[${stopReason}]`);
+    return {
+        best,
+        frontier,
+        baselineScore: baselineEval.score,
+        baselineEval,
+        iterationsRun: maxIterationSeen,
+        stopReason,
+    };
+}
+// -- Mutation generation -----------------------------------------------------
+async function generateMutation(parent, target, llm, iteration, maxIterations) {
+    for (let attempt = 0; attempt <= MAX_MUTATION_RETRIES; attempt++) {
+        try {
+            const reflectionPrompt = buildReflectionPrompt(parent, target, iteration, maxIterations);
+            const response = await llm.complete(reflectionPrompt, REFLECTION_SYSTEM_PROMPT);
+            const mutated = cleanMutationResponse(response);
+            if (!mutated || mutated.length < 50) {
+                console.warn(`[gepa] Mutation too short (${mutated?.length ?? 0} chars), ` +
+                    `retry ${attempt + 1}/${MAX_MUTATION_RETRIES + 1}`);
+                continue;
+            }
+            const violations = validateConstraints(mutated, target.constraints);
+            if (violations.length > 0) {
+                console.warn(`[gepa] Mutation violates ${violations.length} constraint(s), ` +
+                    `retry ${attempt + 1}/${MAX_MUTATION_RETRIES + 1}`);
+                continue;
+            }
+            if (mutated.trim() === parent.content.trim()) {
+                console.warn(`[gepa] Mutation identical to parent, retry ${attempt + 1}/${MAX_MUTATION_RETRIES + 1}`);
+                continue;
+            }
+            return mutated;
+        }
+        catch (error) {
+            const msg = error instanceof Error ? error.message : String(error);
+            console.error(`[gepa] Mutation LLM call failed (attempt ${attempt + 1}/${MAX_MUTATION_RETRIES + 1}): ${msg}`);
+            if (attempt >= MAX_MUTATION_RETRIES)
+                return null;
+        }
+    }
+    return null;
+}
+function cleanMutationResponse(response) {
+    let cleaned = response.trim();
+    const fenceMatch = cleaned.match(/^```(?:markdown|md|text|txt)?\s*\n([\s\S]*?)\n?```\s*$/);
+    if (fenceMatch) {
+        cleaned = fenceMatch[1].trim();
+    }
+    if ((cleaned.startsWith('"') && cleaned.endsWith('"')) ||
+        (cleaned.startsWith("'") && cleaned.endsWith("'"))) {
+        cleaned = cleaned.slice(1, -1).trim();
+    }
+    return cleaned;
+}
+export { buildReflectionPrompt, validateConstraints, selectParent, REFLECTION_SYSTEM_PROMPT, EARLY_STOP_SCORE, STAGNATION_LIMIT, };
+//# sourceMappingURL=optimizer.js.map

package/dist/gepa/optimizer.js.map

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

package/dist/gepa/targets.d.ts

@@ -0,0 +1,39 @@
+/**
+ * GEPA target definitions — what prompts/skills can be optimized.
+ *
+ * Each target knows how to load its current content, where the source lives,
+ * and what constraints must be preserved during optimization.
+ *
+ * Targets:
+ *   1. wiki-system-prompt       — Wiki agent persona (templates/prompts.ts)
+ *   2. ingest-prompt            — Source ingestion (templates/prompts.ts)
+ *   3. query-prompt             — Search result synthesis (templates/prompts.ts)
+ *   4. capture-system-prompt    — Session capture agent (templates/prompts.ts)
+ *   5. capture-prompt           — Auto-capture at shutdown (templates/prompts.ts)
+ *   6. maintenance-system-prompt — Wiki maintenance agent (maintainer.ts, non-exported)
+ *   7. processor-capture-prompt — Daemon capture agent (processor.ts, non-exported)
+ *   8. skill-para               — Active PARA behavioral guidelines (skills/para/SKILL.md)
+ *   9. skill-setup              — Setup instructions (skills/setup/SKILL.md)
+ */
+import type { Target } from "./types.js";
+/** Get the path where an optimized version of a target is saved. */
+export declare function getOptimizedPath(name: string): string;
+/** Get the history directory for a target. */
+export declare function getHistoryDir(name: string): string;
+/** Check if an optimized version exists for a target. */
+export declare function isOptimized(name: string): Promise<boolean>;
+/** A loaded target with its content ready. */
+export interface LoadedTarget extends Target {
+    displayName: string;
+    filePath: string;
+}
+/**
+ * Load a single target by name.
+ * @throws if target name is not recognized
+ */
+export declare function loadTarget(name: string): LoadedTarget;
+/** Load all targets. */
+export declare function listTargets(): LoadedTarget[];
+/** Get all target names. */
+export declare function listTargetNames(): string[];
+//# sourceMappingURL=targets.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"targets.d.ts","sourceRoot":"","sources":["../../src/gepa/targets.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAQH,OAAO,KAAK,EAAE,MAAM,EAAc,MAAM,YAAY,CAAC;AAiBrD,oEAAoE;AACpE,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAErD;AAED,8CAA8C;AAC9C,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAElD;AAED,yDAAyD;AACzD,wBAAsB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAEhE;AAgSD,8CAA8C;AAC9C,MAAM,WAAW,YAAa,SAAQ,MAAM;IAC1C,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,CAkBrD;AAED,wBAAwB;AACxB,wBAAgB,WAAW,IAAI,YAAY,EAAE,CAW5C;AAED,4BAA4B;AAC5B,wBAAgB,eAAe,IAAI,MAAM,EAAE,CAE1C"}

package/dist/gepa/targets.js

@@ -0,0 +1,326 @@
+/**
+ * GEPA target definitions — what prompts/skills can be optimized.
+ *
+ * Each target knows how to load its current content, where the source lives,
+ * and what constraints must be preserved during optimization.
+ *
+ * Targets:
+ *   1. wiki-system-prompt       — Wiki agent persona (templates/prompts.ts)
+ *   2. ingest-prompt            — Source ingestion (templates/prompts.ts)
+ *   3. query-prompt             — Search result synthesis (templates/prompts.ts)
+ *   4. capture-system-prompt    — Session capture agent (templates/prompts.ts)
+ *   5. capture-prompt           — Auto-capture at shutdown (templates/prompts.ts)
+ *   6. maintenance-system-prompt — Wiki maintenance agent (maintainer.ts, non-exported)
+ *   7. processor-capture-prompt — Daemon capture agent (processor.ts, non-exported)
+ *   8. skill-para               — Active PARA behavioral guidelines (skills/para/SKILL.md)
+ *   9. skill-setup              — Setup instructions (skills/setup/SKILL.md)
+ */
+import { readFile } from "node:fs/promises";
+import { join, dirname } from "node:path";
+import { existsSync } from "node:fs";
+import { homedir } from "node:os";
+import { fileURLToPath } from "node:url";
+// -- Path helpers ------------------------------------------------------------
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+/** Project root (two levels up from src/gepa/ → dist/gepa/ at runtime). */
+function getProjectRoot() {
+    // At build time: src/gepa/targets.ts → project root is ../../
+    // At runtime: dist/gepa/targets.js → project root is ../../
+    return join(__dirname, "..", "..");
+}
+/** Optimized prompts directory. */
+const GEPA_DIR = join(homedir(), ".pi", "wiki", "gepa");
+/** Get the path where an optimized version of a target is saved. */
+export function getOptimizedPath(name) {
+    return join(GEPA_DIR, "optimized", `${name}.txt`);
+}
+/** Get the history directory for a target. */
+export function getHistoryDir(name) {
+    return join(GEPA_DIR, "history", name);
+}
+/** Check if an optimized version exists for a target. */
+export async function isOptimized(name) {
+    return existsSync(getOptimizedPath(name));
+}
+// -- Non-exported prompt extraction ------------------------------------------
+/**
+ * Extract a template literal from a TypeScript source file.
+ *
+ * Finds a `const NAME = \`...\`` pattern and extracts the content.
+ * Falls back to searching the dist JS file if the TS source isn't found.
+ */
+async function extractTemplLiteralFromSource(filePath, varName) {
+    // Try .ts first, then .js (runtime in dist/)
+    let actualPath = filePath;
+    if (!existsSync(actualPath)) {
+        actualPath = filePath.replace(/\.ts$/, ".js");
+    }
+    if (!existsSync(actualPath)) {
+        // Try relative to project root
+        const root = getProjectRoot();
+        actualPath = join(root, "src", filePath.split("/src/").pop() ?? "");
+        if (!existsSync(actualPath)) {
+            actualPath = join(root, "dist", filePath.split("/src/").pop()?.replace(/\.ts$/, ".js") ?? "");
+        }
+    }
+    const source = await readFile(actualPath, "utf-8");
+    // Match: const NAME = `...`; (possibly with line-spanning content)
+    const pattern = new RegExp(`(?:const|let|var)\\s+${varName}\\s*=\\s*\`([\\s\\S]*?)\`\\s*;`);
+    const match = source.match(pattern);
+    if (!match || !match[1]) {
+        throw new Error(`[gepa] Could not extract "${varName}" from ${actualPath}. ` +
+            `Make sure the variable is defined as a template literal.`);
+    }
+    // Unescape template literal content
+    return match[1]
+        .replace(/\\`/g, "`")
+        .replace(/\\\$/g, "$")
+        .replace(/\\\\/g, "\\");
+}
+/**
+ * Extract SKILL.md content, stripping YAML frontmatter.
+ */
+async function loadSkillContent(filePath) {
+    const raw = await readFile(filePath, "utf-8");
+    // Strip YAML frontmatter (--- ... ---)
+    const fmMatch = raw.match(/^---\s*\n[\s\S]*?\n---\s*\n/);
+    if (fmMatch) {
+        return raw.slice(fmMatch[0].length).trim();
+    }
+    return raw.trim();
+}
+function flattenConstraints(c) {
+    return c.requiredConcepts;
+}
+function buildTargets() {
+    const root = getProjectRoot();
+    return [
+        {
+            name: "wiki-system-prompt",
+            type: "prompt",
+            displayName: "Wiki System Prompt",
+            description: "System prompt for the standalone wiki agent — persona and rules for PARA wiki management",
+            filePath: join(root, "src/templates/prompts.ts"),
+            constraints: {
+                requiredConcepts: [
+                    "PARA categories (resources, areas, projects, archives)",
+                    "scope must be kebab-case project name",
+                    "tags must be kebab-case",
+                    "wikilinks to connect related pages",
+                    "never include API keys or secrets",
+                    "wiki summary format",
+                    "index is auto-rebuilt",
+                ],
+            },
+            async getContent() {
+                const { WIKI_SYSTEM_PROMPT } = await import("../templates/prompts.js");
+                return WIKI_SYSTEM_PROMPT;
+            },
+        },
+        {
+            name: "ingest-prompt",
+            type: "prompt",
+            displayName: "Ingest Prompt",
+            description: "Instructions for integrating new source material into the wiki",
+            filePath: join(root, "src/templates/prompts.ts"),
+            constraints: {
+                requiredConcepts: [
+                    "review existing pages before creating new ones",
+                    "PARA category assignment with resources as default",
+                    "wiki summary format (Topic, Key Facts, Insights, Connections, Open Questions, Sources)",
+                    "flag contradictions",
+                    "scope must be kebab-case",
+                    "wikilinks and Connections section",
+                ],
+            },
+            async getContent() {
+                const { INGEST_PROMPT } = await import("../templates/prompts.js");
+                return INGEST_PROMPT;
+            },
+        },
+        {
+            name: "query-prompt",
+            type: "prompt",
+            displayName: "Query Prompt",
+            description: "Instructions for synthesizing answers from wiki search results",
+            filePath: join(root, "src/templates/prompts.ts"),
+            constraints: {
+                requiredConcepts: [
+                    "cite specific pages using wikilink references",
+                    "freshness verification",
+                    "self-healing — fix incorrect wiki pages",
+                    "note gaps in wiki coverage",
+                ],
+            },
+            async getContent() {
+                const { QUERY_PROMPT } = await import("../templates/prompts.js");
+                return QUERY_PROMPT;
+            },
+        },
+        {
+            name: "capture-system-prompt",
+            type: "prompt",
+            displayName: "Capture System Prompt",
+            description: "System prompt for the standalone capture agent in templates/prompts.ts",
+            filePath: join(root, "src/templates/prompts.ts"),
+            constraints: {
+                requiredConcepts: [
+                    "PARA category rules",
+                    "scope must be kebab-case project name",
+                    "never include API keys, tokens, passwords, or secrets",
+                    "search wiki_query before creating pages",
+                    "update existing pages instead of creating duplicates",
+                    "wiki summary format",
+                    "index is auto-rebuilt",
+                    "capture architecture decisions, debugging solutions, server details, configs",
+                ],
+            },
+            async getContent() {
+                const { CAPTURE_SYSTEM_PROMPT } = await import("../templates/prompts.js");
+                return CAPTURE_SYSTEM_PROMPT;
+            },
+        },
+        {
+            name: "capture-prompt",
+            type: "prompt",
+            displayName: "Capture Prompt",
+            description: "Prompt template for auto-capture at session shutdown",
+            filePath: join(root, "src/templates/prompts.ts"),
+            constraints: {
+                requiredConcepts: [
+                    "capture ALL project-relevant knowledge",
+                    "use wiki_query to search for existing pages first",
+                    "prefer updating over creating",
+                    "include session file path in Sources",
+                    "do NOT pass indexContent",
+                ],
+            },
+            async getContent() {
+                const { CAPTURE_PROMPT } = await import("../templates/prompts.js");
+                return CAPTURE_PROMPT;
+            },
+        },
+        {
+            name: "maintenance-system-prompt",
+            type: "prompt",
+            displayName: "Maintenance System Prompt",
+            description: "System prompt for the wiki maintenance agent (non-exported, in maintainer.ts)",
+            filePath: join(root, "src/maintainer.ts"),
+            constraints: {
+                requiredConcepts: [
+                    "duplicate detection and merging",
+                    "wikilink discovery",
+                    "PARA category review with resources as default",
+                    "tag cleanup kebab-case",
+                    "content quality (Topic, Key Facts, Connections)",
+                    "staleness review",
+                    "project lifecycle review",
+                    "conservative approach — when unsure leave it alone",
+                    "never include secrets",
+                ],
+            },
+            async getContent() {
+                return extractTemplLiteralFromSource(join(root, "src/maintainer.ts"), "MAINTENANCE_SYSTEM_PROMPT");
+            },
+        },
+        {
+            name: "processor-capture-prompt",
+            type: "prompt",
+            displayName: "Processor Capture Prompt",
+            description: "System prompt for the daemon's session capture agent (non-exported, in processor.ts)",
+            filePath: join(root, "src/processor.ts"),
+            constraints: {
+                requiredConcepts: [
+                    "PARA category rules",
+                    "scope must be kebab-case project name",
+                    "never include API keys, tokens, passwords, or secrets",
+                    "search wiki_query before creating pages",
+                    "update existing pages over creating duplicates",
+                    "session exploration tools (session_stats, session_search, session_slice)",
+                    "wiki summary format (Topic, Key Facts, Insights, Sources)",
+                ],
+            },
+            async getContent() {
+                return extractTemplLiteralFromSource(join(root, "src/processor.ts"), "CAPTURE_SYSTEM_PROMPT");
+            },
+        },
+        {
+            name: "skill-para",
+            type: "skill",
+            displayName: "PARA Skill",
+            description: "Active PARA behavioral guidelines — tells agents how to use the wiki during work",
+            filePath: join(root, "skills/para/SKILL.md"),
+            constraints: {
+                requiredConcepts: [
+                    "wiki_query before planning",
+                    "wiki_write for decisions and solutions",
+                    "resources for almost everything",
+                    "projects only for goals with end dates",
+                    "scope must be kebab-case project name",
+                    "wikilinks",
+                ],
+            },
+            async getContent() {
+                return loadSkillContent(join(root, "skills/para/SKILL.md"));
+            },
+        },
+        {
+            name: "skill-setup",
+            type: "skill",
+            displayName: "Setup Skill",
+            description: "Setup instructions for pi-para — install, configure, and start",
+            filePath: join(root, "skills/setup/SKILL.md"),
+            constraints: {
+                requiredConcepts: [
+                    "qmd search engine",
+                    "configure providers",
+                    "daemon",
+                ],
+            },
+            async getContent() {
+                return loadSkillContent(join(root, "skills/setup/SKILL.md"));
+            },
+        },
+    ];
+}
+/**
+ * Load a single target by name.
+ * @throws if target name is not recognized
+ */
+export function loadTarget(name) {
+    const targets = buildTargets();
+    const def = targets.find((t) => t.name === name);
+    if (!def) {
+        const valid = targets.map((t) => t.name).join(", ");
+        throw new Error(`[gepa] Unknown target "${name}". Valid targets: ${valid}`);
+    }
+    return {
+        name: def.name,
+        type: def.type,
+        displayName: def.displayName,
+        description: def.description,
+        sourcePath: def.filePath,
+        constraints: flattenConstraints(def.constraints),
+        getCurrentContent: def.getContent,
+        filePath: def.filePath,
+    };
+}
+/** Load all targets. */
+export function listTargets() {
+    return buildTargets().map((def) => ({
+        name: def.name,
+        type: def.type,
+        displayName: def.displayName,
+        description: def.description,
+        sourcePath: def.filePath,
+        constraints: flattenConstraints(def.constraints),
+        getCurrentContent: def.getContent,
+        filePath: def.filePath,
+    }));
+}
+/** Get all target names. */
+export function listTargetNames() {
+    return buildTargets().map((t) => t.name);
+}
+//# sourceMappingURL=targets.js.map