@pupt/cli 0.0.1 → 2.3.0

package/dist/services/pattern-detector.js

@@ -0,0 +1,228 @@
+export class PatternDetector {
+    MIN_FREQUENCY_THRESHOLD = 3;
+    detectPatterns(annotations) {
+        const patterns = [];
+        // Detect verification gap patterns
+        const verificationGapPattern = this.detectVerificationGaps(annotations);
+        if (verificationGapPattern) {
+            patterns.push(verificationGapPattern);
+        }
+        // Detect incomplete task patterns
+        const incompleteTaskPattern = this.detectIncompleteTasks(annotations);
+        if (incompleteTaskPattern) {
+            patterns.push(incompleteTaskPattern);
+        }
+        // Detect environment-specific patterns
+        const environmentPattern = this.detectEnvironmentSpecificFailures(annotations);
+        if (environmentPattern) {
+            patterns.push(environmentPattern);
+        }
+        // Detect ambiguous objective patterns
+        const ambiguousPattern = this.detectAmbiguousObjectives(annotations);
+        if (ambiguousPattern) {
+            patterns.push(ambiguousPattern);
+        }
+        return patterns;
+    }
+    detectVerificationGaps(annotations) {
+        const verificationPatterns = [
+            /test.*fail.*claim.*success/i,
+            /claim.*success.*fail/i,
+            /verification.*fail/i,
+            /still failing/i,
+            /test.*still.*fail/i,
+            /claim.*complete.*fail/i,
+            /said.*done.*fail/i,
+        ];
+        const matches = annotations.filter(annotation => {
+            const isFailure = annotation.status === 'partial' || annotation.status === 'failure';
+            const hasVerificationIssue = verificationPatterns.some(pattern => pattern.test(annotation.notes));
+            // Also check for generic failure patterns when it's a failure status
+            const hasFailurePattern = annotation.status === 'failure' &&
+                (annotation.notes.toLowerCase().includes('fail') ||
+                    annotation.notes.toLowerCase().includes('error') ||
+                    annotation.notes.toLowerCase().includes('pattern'));
+            return isFailure && (hasVerificationIssue || hasFailurePattern);
+        });
+        if (matches.length < this.MIN_FREQUENCY_THRESHOLD) {
+            return null;
+        }
+        return {
+            type: 'verification_gap',
+            frequency: matches.length,
+            severity: this.calculateSeverity(matches.length, annotations.length),
+            evidence: matches.map(m => this.truncateEvidence(m.notes)),
+            affectedPrompts: this.getUniquePrompts(matches),
+            correlation_strength: this.calculateCorrelationStrength(matches, annotations),
+            affected_executions: matches.length,
+        };
+    }
+    detectIncompleteTasks(annotations) {
+        const incompletePatterns = [
+            /stopped.*first.*error/i,
+            /incomplete.*task/i,
+            /did not.*complete.*all/i,
+            /only.*fixed.*one/i,
+            /left.*other.*fail/i,
+            /did not.*continue/i,
+            /partial.*implementation/i,
+            /incomplete/i,
+            /stopped.*after/i,
+        ];
+        const matches = annotations.filter(annotation => {
+            const isPartial = annotation.status === 'partial';
+            const hasIncompletePattern = incompletePatterns.some(pattern => pattern.test(annotation.notes));
+            return isPartial && hasIncompletePattern;
+        });
+        if (matches.length < this.MIN_FREQUENCY_THRESHOLD) {
+            return null;
+        }
+        return {
+            type: 'incomplete_task',
+            frequency: matches.length,
+            severity: this.calculateSeverity(matches.length, annotations.length),
+            evidence: matches.map(m => this.truncateEvidence(m.notes)),
+            affectedPrompts: this.getUniquePrompts(matches),
+            correlation_strength: this.calculateCorrelationStrength(matches, annotations),
+            affected_executions: matches.length,
+        };
+    }
+    detectEnvironmentSpecificFailures(annotations) {
+        // Group failures by environment factors
+        const branchFailures = new Map();
+        annotations.forEach(annotation => {
+            if ((annotation.status === 'failure' || annotation.status === 'partial') &&
+                annotation.environment?.git_branch) {
+                const branch = annotation.environment.git_branch;
+                let failures = branchFailures.get(branch);
+                if (!failures) {
+                    failures = [];
+                    branchFailures.set(branch, failures);
+                }
+                failures.push(annotation);
+            }
+        });
+        // Find branches with high failure rates
+        let maxFailures = 0;
+        let problematicBranch = '';
+        const branchEvidence = [];
+        branchFailures.forEach((failures, branch) => {
+            if (failures.length >= this.MIN_FREQUENCY_THRESHOLD && failures.length > maxFailures) {
+                maxFailures = failures.length;
+                problematicBranch = branch;
+            }
+        });
+        // Collect evidence with branch prefix
+        const problematicFailures = branchFailures.get(problematicBranch) ?? [];
+        if (problematicBranch) {
+            problematicFailures.forEach(f => {
+                branchEvidence.push(`feature/test: ${this.truncateEvidence(f.notes)}`);
+            });
+        }
+        // Also check for environment-related keywords in notes
+        const envPatterns = [
+            /branch.*specific/i,
+            /only.*fail.*branch/i,
+            /environment.*specific/i,
+            /works.*main.*fail/i,
+        ];
+        const envMatches = annotations.filter(annotation => {
+            return envPatterns.some(pattern => pattern.test(annotation.notes));
+        });
+        const totalMatches = Math.max(maxFailures, envMatches.length);
+        if (totalMatches < this.MIN_FREQUENCY_THRESHOLD) {
+            return null;
+        }
+        return {
+            type: 'environment_specific',
+            frequency: totalMatches,
+            severity: this.calculateSeverity(totalMatches, annotations.length),
+            evidence: branchEvidence.length > 0 ? branchEvidence : envMatches.map(m => this.truncateEvidence(m.notes)),
+            affectedPrompts: this.getUniquePrompts(branchEvidence.length > 0 ?
+                problematicFailures : envMatches),
+            correlation_strength: this.calculateCorrelationStrength(branchEvidence.length > 0 ? problematicFailures : envMatches, annotations),
+            affected_executions: totalMatches,
+        };
+    }
+    detectAmbiguousObjectives(annotations) {
+        const ambiguousPatterns = [
+            /unclear.*what.*meant/i,
+            /ambiguous.*instruction/i,
+            /vague.*instruction/i,
+            /not sure.*which/i,
+            /unclear.*objective/i,
+            /confusing.*requirement/i,
+            /too.*vague/i,
+        ];
+        const matches = annotations.filter(annotation => {
+            const isFailure = annotation.status === 'partial' || annotation.status === 'failure';
+            const hasAmbiguousPattern = ambiguousPatterns.some(pattern => pattern.test(annotation.notes));
+            return isFailure && hasAmbiguousPattern;
+        });
+        if (matches.length < this.MIN_FREQUENCY_THRESHOLD) {
+            return null;
+        }
+        return {
+            type: 'ambiguous_objective',
+            frequency: matches.length,
+            severity: this.calculateSeverity(matches.length, annotations.length),
+            evidence: matches.map(m => this.truncateEvidence(m.notes)),
+            affectedPrompts: this.getUniquePrompts(matches),
+            correlation_strength: this.calculateCorrelationStrength(matches, annotations),
+            affected_executions: matches.length,
+        };
+    }
+    calculateSeverity(frequency, total) {
+        if (total === 0) {
+            return 'low';
+        }
+        const percentage = frequency / total;
+        if (percentage > 0.5) {
+            return 'critical';
+        }
+        if (percentage >= 0.3) {
+            return 'high';
+        }
+        if (percentage >= 0.15) {
+            return 'medium';
+        }
+        return 'low';
+    }
+    calculateCorrelationStrength(matches, allAnnotations) {
+        if (allAnnotations.length === 0) {
+            return 0;
+        }
+        // Calculate correlation based on:
+        // 1. How many of the failures have this pattern
+        // 2. How specific the pattern is to failures
+        const totalFailures = allAnnotations.filter(a => a.status === 'partial' || a.status === 'failure').length;
+        if (totalFailures === 0) {
+            return 0;
+        }
+        // Proportion of failures that have this pattern
+        const failureCorrelation = matches.length / totalFailures;
+        // Specificity: how much this pattern appears in failures vs successes
+        const successesWithPattern = allAnnotations.filter(a => a.status === 'success' &&
+            matches.some(m => m.notes === a.notes)).length;
+        const specificity = successesWithPattern === 0 ? 1 :
+            matches.length / (matches.length + successesWithPattern);
+        // Combined correlation strength
+        return Math.min(failureCorrelation * specificity, 1.0);
+    }
+    getUniquePrompts(annotations) {
+        const prompts = new Set();
+        annotations.forEach(a => {
+            if (a.promptName) {
+                prompts.add(a.promptName);
+            }
+        });
+        return Array.from(prompts);
+    }
+    truncateEvidence(text, maxLength = 100) {
+        if (text.length <= maxLength) {
+            return text;
+        }
+        return `${text.substring(0, maxLength - 3)}...`;
+    }
+}
+//# sourceMappingURL=pattern-detector.js.map

package/dist/services/pattern-detector.js.map

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

package/dist/services/prompt-resolver.d.ts

@@ -0,0 +1,32 @@
+import type { ModuleEntry } from '@pupt/lib';
+import type { EnvironmentConfig } from '../types/config.js';
+export interface ResolvedPrompt {
+    text: string;
+    templateInfo: {
+        templatePath: string;
+        templateContent: string;
+        variables: Map<string, unknown>;
+        finalPrompt: string;
+        title?: string;
+        summary?: string;
+        reviewFiles?: Array<{
+            name: string;
+            value: unknown;
+        }>;
+        timestamp?: Date;
+    };
+}
+export interface ResolvePromptOptions {
+    modules: ModuleEntry[];
+    promptName?: string;
+    noInteractive?: boolean;
+    startTimestamp?: Date;
+    /** Environment configuration for prompt rendering */
+    environment?: EnvironmentConfig;
+}
+/**
+ * Discover, select, collect inputs, and render a prompt.
+ * Shared by both the default `pt` action and `pt run`.
+ */
+export declare function resolvePrompt(options: ResolvePromptOptions): Promise<ResolvedPrompt>;
+//# sourceMappingURL=prompt-resolver.d.ts.map

package/dist/services/prompt-resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt-resolver.d.ts","sourceRoot":"","sources":["../../src/services/prompt-resolver.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAG7C,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAO5D,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE;QACZ,YAAY,EAAE,MAAM,CAAC;QACrB,eAAe,EAAE,MAAM,CAAC;QACxB,SAAS,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAChC,WAAW,EAAE,MAAM,CAAC;QACpB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,WAAW,CAAC,EAAE,KAAK,CAAC;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,KAAK,EAAE,OAAO,CAAA;SAAE,CAAC,CAAC;QACtD,SAAS,CAAC,EAAE,IAAI,CAAC;KAClB,CAAC;CACH;AAED,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,WAAW,EAAE,CAAC;IACvB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,cAAc,CAAC,EAAE,IAAI,CAAC;IACtB,qDAAqD;IACrD,WAAW,CAAC,EAAE,iBAAiB,CAAC;CACjC;AAED;;;GAGG;AACH,wBAAsB,aAAa,CAAC,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,cAAc,CAAC,CAsE1F"}

package/dist/services/prompt-resolver.js

@@ -0,0 +1,73 @@
+import chalk from 'chalk';
+import { InteractiveSearch } from '../ui/interactive-search.js';
+import { errors } from '../utils/errors.js';
+import { logger } from '../utils/logger.js';
+import { collectInputs } from './input-collector.js';
+import { PuptService } from './pupt-service.js';
+/**
+ * Discover, select, collect inputs, and render a prompt.
+ * Shared by both the default `pt` action and `pt run`.
+ */
+export async function resolvePrompt(options) {
+    const { modules, promptName, noInteractive, startTimestamp, environment } = options;
+    // Discover prompts with environment config
+    const puptService = new PuptService({ modules, environment });
+    await puptService.init();
+    // Display any module loading warnings
+    for (const warning of puptService.getWarnings()) {
+        logger.warn(warning);
+    }
+    let selected;
+    if (promptName) {
+        // Find specific prompt by name
+        const jsxPrompt = puptService.findPrompt(promptName);
+        const adapted = jsxPrompt
+            ? puptService.getPromptsAsAdapted().find(p => p._source === jsxPrompt)
+            : undefined;
+        if (!adapted) {
+            throw errors.promptNotFound(promptName);
+        }
+        selected = adapted;
+        logger.log(chalk.blue(`\nUsing prompt: ${selected.title}`));
+        logger.log(chalk.dim(`Location: ${selected.path}\n`));
+    }
+    else {
+        // Interactive search
+        const prompts = puptService.getPromptsAsAdapted();
+        if (prompts.length === 0) {
+            throw errors.noPromptsFound([]);
+        }
+        const search = new InteractiveSearch();
+        selected = await search.selectPrompt(prompts);
+        logger.log(chalk.blue(`\nProcessing: ${selected.title}`));
+        logger.log(chalk.dim(`Location: ${selected.path}\n`));
+    }
+    // Collect inputs and render (wrap with environment if configured)
+    if (!selected._source) {
+        throw errors.promptNotFound(promptName ?? 'unknown');
+    }
+    const dp = puptService.wrapWithEnvironment(selected._source);
+    const inputs = await collectInputs(dp.getInputIterator(), noInteractive);
+    const renderResult = await dp.render({ inputs });
+    const { text } = renderResult;
+    const reviewFiles = renderResult.postExecution
+        ?.filter((a) => a.type === 'reviewFile')
+        .map((a) => ({
+        name: a.file || '',
+        value: a.file || '',
+    }));
+    return {
+        text,
+        templateInfo: {
+            templatePath: selected.path,
+            templateContent: selected.content,
+            variables: inputs,
+            finalPrompt: text,
+            title: selected.title,
+            summary: selected.summary,
+            reviewFiles,
+            timestamp: startTimestamp,
+        },
+    };
+}
+//# sourceMappingURL=prompt-resolver.js.map

package/dist/services/prompt-resolver.js.map

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

package/dist/services/pupt-prompt-source.d.ts

@@ -0,0 +1,16 @@
+import type { PromptSource } from '@pupt/lib';
+/**
+ * Recursively scan a directory for .prompt files and return
+ * one PromptSource per file.
+ *
+ * This handles several gaps in pupt-lib's LocalPromptSource:
+ * 1. Recursive subdirectory scanning
+ * 2. JSX comment stripping at top of file
+ * 3. Neutralizing {inputs.xxx} references (so they don't throw ReferenceError)
+ * 4. Per-file error isolation (each file is its own module entry)
+ *
+ * Files are returned as .prompt so pupt-lib handles all preprocessing
+ * (imports, fragment wrapping, Babel transform, fragment unwrapping).
+ */
+export declare function scanLocalPromptDir(dirPath: string): Promise<PromptSource[]>;
+//# sourceMappingURL=pupt-prompt-source.d.ts.map

package/dist/services/pupt-prompt-source.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pupt-prompt-source.d.ts","sourceRoot":"","sources":["../../src/services/pupt-prompt-source.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAuB,YAAY,EAAE,MAAM,WAAW,CAAC;AAwBnE;;;;;;;;;;;;GAYG;AACH,wBAAsB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,CAuBjF"}

package/dist/services/pupt-prompt-source.js

@@ -0,0 +1,74 @@
+import path from 'node:path';
+import fs from 'fs-extra';
+/**
+ * A PromptSource wrapping a single preprocessed file.
+ * Using one source per file gives per-file error isolation through
+ * pupt-lib's per-module error handling in Pupt.discoverPrompts().
+ *
+ * The `name` property provides a human-readable identifier used by
+ * pupt-lib for error messages (via getEntryDisplayName).
+ */
+class SingleFilePromptSource {
+    file;
+    name;
+    constructor(file, originalFilename) {
+        this.file = file;
+        this.name = originalFilename;
+    }
+    getPrompts() {
+        return Promise.resolve([this.file]);
+    }
+}
+/**
+ * Recursively scan a directory for .prompt files and return
+ * one PromptSource per file.
+ *
+ * This handles several gaps in pupt-lib's LocalPromptSource:
+ * 1. Recursive subdirectory scanning
+ * 2. JSX comment stripping at top of file
+ * 3. Neutralizing {inputs.xxx} references (so they don't throw ReferenceError)
+ * 4. Per-file error isolation (each file is its own module entry)
+ *
+ * Files are returned as .prompt so pupt-lib handles all preprocessing
+ * (imports, fragment wrapping, Babel transform, fragment unwrapping).
+ */
+export async function scanLocalPromptDir(dirPath) {
+    const resolvedPath = path.resolve(dirPath);
+    if (!await fs.pathExists(resolvedPath)) {
+        return [];
+    }
+    const files = [];
+    await scanRecursive(resolvedPath, files);
+    const sources = [];
+    for (const file of files) {
+        let content = await fs.readFile(file.fullPath, 'utf-8');
+        // Strip JSX comments at top of file (e.g., {/* Converted from test.md */})
+        content = content.trim().replace(/^\{\/\*[\s\S]*?\*\/\}\s*/g, '');
+        // Neutralize {inputs.xxx} references to prevent ReferenceError during compilation.
+        // Input discovery works through <Ask> components, not these expressions.
+        // Actual input values are substituted by pupt-lib's render() at render time.
+        content = neutralizeInputRefs(content);
+        sources.push(new SingleFilePromptSource({ filename: file.filename, content }, file.filename));
+    }
+    return sources;
+}
+async function scanRecursive(dir, results) {
+    const entries = await fs.readdir(dir, { withFileTypes: true });
+    for (const entry of entries) {
+        const fullPath = path.join(dir, entry.name);
+        if (entry.isDirectory()) {
+            await scanRecursive(fullPath, results);
+        }
+        else if (entry.isFile() && entry.name.endsWith('.prompt')) {
+            results.push({ fullPath, filename: entry.name });
+        }
+    }
+}
+/**
+ * Replace {inputs.xxx} expressions with {""} to prevent ReferenceError
+ * during compilation. The <Ask> components remain intact for input discovery.
+ */
+function neutralizeInputRefs(content) {
+    return content.replace(/\{inputs\.\w+\}/g, '{""}');
+}
+//# sourceMappingURL=pupt-prompt-source.js.map

package/dist/services/pupt-prompt-source.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pupt-prompt-source.js","sourceRoot":"","sources":["../../src/services/pupt-prompt-source.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAG7B,OAAO,EAAE,MAAM,UAAU,CAAC;AAE1B;;;;;;;GAOG;AACH,MAAM,sBAAsB;IAGhB;IAFD,IAAI,CAAS;IACtB,YACU,IAA0B,EAClC,gBAAwB;QADhB,SAAI,GAAJ,IAAI,CAAsB;QAGlC,IAAI,CAAC,IAAI,GAAG,gBAAgB,CAAC;IAC/B,CAAC;IACD,UAAU;QACR,OAAO,OAAO,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;IACtC,CAAC;CACF;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,OAAe;IACtD,MAAM,YAAY,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IAC3C,IAAI,CAAC,MAAM,EAAE,CAAC,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;QAAA,OAAO,EAAE,CAAC;IAAA,CAAC;IAEpD,MAAM,KAAK,GAA6C,EAAE,CAAC;IAC3D,MAAM,aAAa,CAAC,YAAY,EAAE,KAAK,CAAC,CAAC;IAEzC,MAAM,OAAO,GAAmB,EAAE,CAAC;IACnC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,OAAO,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QAExD,2EAA2E;QAC3E,OAAO,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,2BAA2B,EAAE,EAAE,CAAC,CAAC;QAElE,mFAAmF;QACnF,yEAAyE;QACzE,6EAA6E;QAC7E,OAAO,GAAG,mBAAmB,CAAC,OAAO,CAAC,CAAC;QAEvC,OAAO,CAAC,IAAI,CAAC,IAAI,sBAAsB,CAAC,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,OAAO,EAAE,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC;IAChG,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,KAAK,UAAU,aAAa,CAC1B,GAAW,EACX,OAAiD;IAEjD,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;IAC/D,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;QAC5C,IAAI,KAAK,CAAC,WAAW,EAAE,EAAE,CAAC;YACxB,MAAM,aAAa,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QACzC,CAAC;aAAM,IAAI,KAAK,CAAC,MAAM,EAAE,IAAI,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC;YAC5D,OAAO,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,QAAQ,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;QACnD,CAAC;IACH,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,SAAS,mBAAmB,CAAC,OAAe;IAC1C,OAAO,OAAO,CAAC,OAAO,CAAC,kBAAkB,EAAE,MAAM,CAAC,CAAC;AACrD,CAAC"}

package/dist/services/pupt-service.d.ts

@@ -0,0 +1,33 @@
+import { type DiscoveredPromptWithMethods, type ModuleEntry } from "@pupt/lib";
+import type { EnvironmentConfig } from "../types/config.js";
+import { Prompt } from "../types/prompt.js";
+export interface PuptServiceConfig {
+    modules: ModuleEntry[];
+    /** Environment configuration for prompt rendering */
+    environment?: EnvironmentConfig;
+}
+/**
+ * Service that discovers and manages pupt-lib prompts.
+ * Delegates all prompt discovery and compilation to pupt-lib's Pupt class.
+ */
+export declare class PuptService {
+    private pupt;
+    private config;
+    private initialized;
+    constructor(config: PuptServiceConfig);
+    init(): Promise<void>;
+    getPrompts(): DiscoveredPromptWithMethods[];
+    getWarnings(): string[];
+    /**
+     * Get all discovered prompts as pupt Prompt objects (for use with search/UI).
+     */
+    getPromptsAsAdapted(): Prompt[];
+    getPrompt(name: string): DiscoveredPromptWithMethods | undefined;
+    findPrompt(nameOrFilename: string): DiscoveredPromptWithMethods | undefined;
+    /**
+     * Wrap a DiscoveredPromptWithMethods to inject default environment config into render calls.
+     * Returns a new object with the same interface but with env config merged.
+     */
+    wrapWithEnvironment(dp: DiscoveredPromptWithMethods): DiscoveredPromptWithMethods;
+}
+//# sourceMappingURL=pupt-service.d.ts.map

package/dist/services/pupt-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pupt-service.d.ts","sourceRoot":"","sources":["../../src/services/pupt-service.ts"],"names":[],"mappings":"AAAA,OAAO,EAEH,KAAK,2BAA2B,EAGhC,KAAK,WAAW,EAInB,MAAM,WAAW,CAAC;AAEnB,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAC5D,OAAO,EAAwB,MAAM,EAAE,MAAM,oBAAoB,CAAC;AA8DlE,MAAM,WAAW,iBAAiB;IAC9B,OAAO,EAAE,WAAW,EAAE,CAAC;IACvB,qDAAqD;IACrD,WAAW,CAAC,EAAE,iBAAiB,CAAC;CACnC;AAED;;;GAGG;AACH,qBAAa,WAAW;IACpB,OAAO,CAAC,IAAI,CAAO;IACnB,OAAO,CAAC,MAAM,CAAoB;IAClC,OAAO,CAAC,WAAW,CAAS;gBAEhB,MAAM,EAAE,iBAAiB;IAK/B,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAQ3B,UAAU,IAAI,2BAA2B,EAAE;IAI3C,WAAW,IAAI,MAAM,EAAE;IAIvB;;OAEG;IACH,mBAAmB,IAAI,MAAM,EAAE;IAI/B,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,2BAA2B,GAAG,SAAS;IAIhE,UAAU,CAAC,cAAc,EAAE,MAAM,GAAG,2BAA2B,GAAG,SAAS;IAK3E;;;OAGG;IACH,mBAAmB,CAAC,EAAE,EAAE,2BAA2B,GAAG,2BAA2B;CAsBpF"}

package/dist/services/pupt-service.js

@@ -0,0 +1,119 @@
+import { createEnvironment, inferProviderFromModel, Pupt, } from "@pupt/lib";
+import { fromDiscoveredPrompt } from "../types/prompt.js";
+/**
+ * Convert pupt's EnvironmentConfig to pupt-lib's EnvironmentContext.
+ * Only includes explicitly configured values (runtime values are auto-detected by pupt-lib).
+ */
+function toEnvironmentContext(envConfig) {
+    if (!envConfig) {
+        return undefined;
+    }
+    const result = {};
+    if (envConfig.llm) {
+        const model = envConfig.llm.model ?? "unspecified";
+        let { provider } = envConfig.llm;
+        if (!provider && model !== "unspecified") {
+            provider = inferProviderFromModel(model) ?? undefined;
+        }
+        const llm = {
+            model,
+            provider: provider ?? "unspecified",
+        };
+        if (envConfig.llm.maxTokens !== undefined) {
+            llm.maxTokens = envConfig.llm.maxTokens;
+        }
+        if (envConfig.llm.temperature !== undefined) {
+            llm.temperature = envConfig.llm.temperature;
+        }
+        result.llm = llm;
+    }
+    if (envConfig.output) {
+        const output = {
+            trim: envConfig.output.trim ?? true,
+            indent: envConfig.output.indent ?? "  ",
+        };
+        if (envConfig.output.format && envConfig.output.format !== "unspecified") {
+            output.format = envConfig.output.format;
+        }
+        result.output = output;
+    }
+    if (envConfig.code) {
+        const code = {
+            language: envConfig.code.language ?? "unspecified",
+        };
+        if (envConfig.code.highlight !== undefined) {
+            code.highlight = envConfig.code.highlight;
+        }
+        result.code = code;
+    }
+    if (envConfig.user) {
+        result.user = {
+            editor: envConfig.user.editor ?? "unknown",
+        };
+    }
+    return result;
+}
+/**
+ * Service that discovers and manages pupt-lib prompts.
+ * Delegates all prompt discovery and compilation to pupt-lib's Pupt class.
+ */
+export class PuptService {
+    pupt;
+    config;
+    initialized = false;
+    constructor(config) {
+        this.config = config;
+        this.pupt = new Pupt({ modules: config.modules });
+    }
+    async init() {
+        if (this.initialized) {
+            return;
+        }
+        await this.pupt.init();
+        this.initialized = true;
+    }
+    getPrompts() {
+        return this.pupt.getPrompts();
+    }
+    getWarnings() {
+        return this.pupt.getWarnings();
+    }
+    /**
+     * Get all discovered prompts as pupt Prompt objects (for use with search/UI).
+     */
+    getPromptsAsAdapted() {
+        return this.getPrompts().map((dp) => fromDiscoveredPrompt(dp));
+    }
+    getPrompt(name) {
+        return this.pupt.getPrompt(name);
+    }
+    findPrompt(nameOrFilename) {
+        const normalized = nameOrFilename.replace(/\.(prompt|tsx|jsx)$/i, "");
+        return this.pupt.getPrompt(nameOrFilename) ?? this.pupt.getPrompt(normalized);
+    }
+    /**
+     * Wrap a DiscoveredPromptWithMethods to inject default environment config into render calls.
+     * Returns a new object with the same interface but with env config merged.
+     */
+    wrapWithEnvironment(dp) {
+        const defaultEnv = this.config.environment;
+        if (!defaultEnv) {
+            return dp;
+        }
+        const envFromConfig = toEnvironmentContext(defaultEnv);
+        if (!envFromConfig) {
+            return dp;
+        }
+        return {
+            ...dp,
+            async render(options) {
+                const mergedEnv = createEnvironment({
+                    ...envFromConfig,
+                    ...options?.env,
+                });
+                return dp.render({ ...options, env: mergedEnv });
+            },
+        };
+    }
+}
+//# sourceMappingURL=pupt-service.js.map

package/dist/services/pupt-service.js.map

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

package/dist/services/review-data-builder.d.ts

@@ -0,0 +1,25 @@
+import type { ModuleEntry } from "@pupt/lib";
+import type { Config } from "../types/config.js";
+import type { ReviewData, ReviewOptions } from "../types/review.js";
+export declare class ReviewDataBuilder {
+    private config;
+    private historyManager;
+    private puptService;
+    private annotationAnalyzer;
+    constructor(config: Config & {
+        modules?: ModuleEntry[];
+    });
+    buildReviewData(options: ReviewOptions): Promise<ReviewData>;
+    private filterBySince;
+    private parseSinceDate;
+    private groupByPrompt;
+    private buildPromptReviewData;
+    private getHistoryFileName;
+    private extractPromptName;
+    private getAnnotations;
+    private calculateUsageStatistics;
+    private calculateExecutionOutcomes;
+    private calculateMetadata;
+    private calculateDataCompleteness;
+}
+//# sourceMappingURL=review-data-builder.d.ts.map

package/dist/services/review-data-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"review-data-builder.d.ts","sourceRoot":"","sources":["../../src/services/review-data-builder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAS7C,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAEjD,OAAO,KAAK,EAIR,UAAU,EAEV,aAAa,EAEhB,MAAM,oBAAoB,CAAC;AAG5B,qBAAa,iBAAiB;IAKd,OAAO,CAAC,MAAM;IAJ1B,OAAO,CAAC,cAAc,CAAiB;IACvC,OAAO,CAAC,WAAW,CAAc;IACjC,OAAO,CAAC,kBAAkB,CAAqB;gBAE3B,MAAM,EAAE,MAAM,GAAG;QAAE,OAAO,CAAC,EAAE,WAAW,EAAE,CAAA;KAAE;IAU1D,eAAe,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,UAAU,CAAC;IAqClE,OAAO,CAAC,aAAa;IAQrB,OAAO,CAAC,cAAc;IAoCtB,OAAO,CAAC,aAAa;YAgBP,qBAAqB;IAmEnC,OAAO,CAAC,kBAAkB;IAK1B,OAAO,CAAC,iBAAiB;YAWX,cAAc;IAqD5B,OAAO,CAAC,wBAAwB;IAyEhC,OAAO,CAAC,0BAA0B;IAwBlC,OAAO,CAAC,iBAAiB;IAmBzB,OAAO,CAAC,yBAAyB;CAuBpC"}